ListObject.DataMember A propriedade (sistema de 2007)

Artigo
08/25/2010

Obtém ou define o membro de dados específico em uma fonte de dados multimember para BIND o ListObject controle.

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

Sintaxe

Public Property DataMember As String

Dim instance As ListObject
Dim value As String

value = instance.DataMember

instance.DataMember = value

public string DataMember { get; set; }

Valor de propriedade

Tipo: System.String
Um membro de dados de uma fonte de dados multimember.O valor padrão é Empty.

Comentários

Não é necessária se a fonte de dados tiver somente um membro.

Use o DataMember propriedade para especificar um membro de uma fonte de dados multimember para BIND a ListObject controle. Por exemplo, se você tiver uma fonte de dados com mais de uma tabela especificada no DataSource propriedade, use o DataMember propriedade para especificar qual tabela para BIND a ListObject controle.

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.

Private Sub ListObject_DataSourceAndMember()
    ' Create a DataSet and two DataTables.
    Dim ordersDataSet As New DataSet("ordersDataSet")
    Dim tableCustomers As New DataTable("Customers")
    Dim tableProducts As 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"))
    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"

End Sub

private void 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

Compartilhar via