ListObject.DataSource A propriedade (sistema de 2007)

Artigo
08/25/2010

Obtém ou define a fonte que contém uma lista de valores que são usados para popular os itens dentro do controle.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v9.0 (em Microsoft.Office.Tools.Excel.v9.0.dll)

Sintaxe

Public Property DataSource As Object

Dim instance As ListObject
Dim value As Object

value = instance.DataSource

instance.DataSource = value

public Object DataSource { get; set; }

Valor de propriedade

Tipo: System.Object
A fonte que contém uma lista de valores que são usados para popular os itens dentro do controle.O valor padrão é nulluma referência nula (Nothing no Visual Basic).

Comentários

Em time de execução, use o SetDataBinding método para conjunto o DataSource e DataMember Propriedades.

As fontes de dados a seguir são válidas:

A DataTable.
A DataView.
A DataSet.
A DataViewManager.
Qualquer componente que implementa o IListSource interface.
Qualquer componente que implementa o IList interface.

Consulte o Binding Visão geral da classe para obter mais informações sobre fontes de dados.

Se o DataSource referência contiver mais de uma tabela ou propriedade, você deve conjunto o DataMember propriedade para uma seqüência de caracteres que especifica a tabela para BIND a. Por exemplo, se o DataSource é um DataSet ou DataViewManager que contém três tabelas chamadas Customers, Orders e OrderDetails, você deve especificar a tabela para BIND a.

Configurando o DataSource um objeto que não implementa o IList interface ou um IListSource fará com que uma exceção seja lançada.

Exemplos

O exemplo de código a seguir cria um DataSet com dois DataTable objetos e preenche uma das tabelas com dados. O código, em seguida, define o DataSource e DataMember propriedades das ListObject Para BIND a tabela que contém dados.

Este exemplo é para uma personalização em nível de documento.

PrivateSub ListObject_DataSourceAndMember()
    ' Create a DataSet and two DataTables.Dim ordersDataSet AsNew DataSet("ordersDataSet")
    Dim tableCustomers AsNew DataTable("Customers")
    Dim tableProducts AsNew DataTable("Products")
    ordersDataSet.Tables.Add(tableCustomers)
    ordersDataSet.Tables.Add(tableProducts)

    ' Add a data to the Customers DataTable.
    tableCustomers.Columns.Add(New DataColumn("LastName"))
    tableCustomers.Columns.Add(New DataColumn("FirstName"))
    Dim dr As DataRow = tableCustomers.NewRow()
    dr("LastName") = "Chan"
    dr("FirstName") = "Gareth"
    tableCustomers.Rows.Add(dr)

    ' Create a list object.Dim List1 As Microsoft.Office.Tools.Excel.ListObject = _
        Me.Controls.AddListObject(Me.Range( _
        "A1"), "Customers")

    ' Bind the list object to the Customers table.
    List1.AutoSetDataBoundColumnHeaders = True
    List1.DataSource = ordersDataSet
    List1.DataMember = "Customers"EndSub

privatevoid ListObject_DataSourceAndMember()
{
    // Create a DataSet and two DataTables.
    DataSet ordersDataSet = new DataSet("ordersDataSet");
    DataTable tableCustomers = new DataTable("Customers");
    DataTable tableProducts = new DataTable("Products");
    ordersDataSet.Tables.Add(tableCustomers);
    ordersDataSet.Tables.Add(tableProducts);

    // Add a data to the Customers DataTable.
    tableCustomers.Columns.Add(new DataColumn("LastName"));
    tableCustomers.Columns.Add(new DataColumn("FirstName"));
    DataRow dr = tableCustomers.NewRow();
    dr["LastName"] = "Chan";
    dr["FirstName"] = "Gareth";
    tableCustomers.Rows.Add(dr);

    // Create a list object.
    Microsoft.Office.Tools.Excel.ListObject list1 = 
        this.Controls.AddListObject(
        this.Range["A1", missing], "Customers");

    // Bind the list object to the Customers table.
    list1.AutoSetDataBoundColumnHeaders = true;
    list1.DataSource = ordersDataSet;
    list1.DataMember = "Customers";
}

Permissões

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de códigos parcialmente Confiável.

Consulte também

Referência

ListObject Classe

Membros ListObject

Namespace Microsoft.Office.Tools.Excel

Partilhar via