ListObject.DataMember Propriedade

Definição

Obtém ou define o membro de dados específico em uma fonte de dados de vários membros a ser associado ao controle ListObject.

public string DataMember { get; set; }

Valor da propriedade

String

Um membro de dados de uma fonte de dados de vários membros. O valor padrão é Empty.

Exemplos

O exemplo de código a seguir cria um DataSet com dois DataTable objetos e popula uma das tabelas com dados. Em seguida, o código define as DataSource DataMember Propriedades e de ListObject para associar à tabela que contém dados.

Este exemplo destina-se a uma personalização no nível de documento.

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"], "Customers");

    // Bind the list object to the Customers table.
    list1.AutoSetDataBoundColumnHeaders = true;
    list1.DataSource = ordersDataSet;
    list1.DataMember = "Customers";
}
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

Comentários

Não é necessário se a fonte de dados tiver apenas um membro.

Use a DataMember propriedade para especificar um membro de uma fonte de dados de multimembro a ser associada ao ListObject controle. Por exemplo, se você tiver uma fonte de dados com mais de uma tabela especificada na DataSource propriedade, use a DataMember propriedade para especificar qual tabela deve ser associada ao ListObject controle.

Aplica-se a