ListObject.DataMember-Eigenschaft

Artikel
08/10/2011

Ruft den spezifischen Datenmember aus einer Datenquelle mit mehreren Membern ab, der an das ListObject-Steuerelement gebunden werden soll, oder legt diesen Datenmember fest.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
Property DataMember As String
    Get
    Set

string DataMember { get; set; }

Eigenschaftswert

Typ: System.String
Ein Datenmember aus einer Datenquelle mit mehreren Membern.Der Standardwert ist Empty.

Hinweise

Wird nicht benötigt, wenn die Datenquelle nur einen Member hat.

Verwenden Sie die DataMember-Eigenschaft, um einen Member aus einer Datenquelle mit mehreren Membern anzugeben, der an das ListObject-Steuerelement gebunden werden soll. Wenn eine Datenquelle beispielsweise über mehr als eine Tabelle verfügt, die in der DataSource-Eigenschaft angegeben sind, verwenden Sie die DataMember-Eigenschaft, um anzugeben, welche Tabelle an das ListObject-Steuerelement gebunden werden soll.

Beispiele

Im folgenden Codebeispiel wird ein DataSet mit zwei DataTable-Objekten erstellt und eine der Tabellen mit Daten aufgefüllt. Anschließend legt der Code die DataSource-Eigenschaft und die DataMember-Eigenschaft des ListObject fest, um eine Bindung an die Tabelle herzustellen, die Daten enthält.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    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";
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

ListObject Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über