ListObject.DataMember-Eigenschaft (2007 System)

Artikel
08/23/2008

Aktualisiert: November 2007

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.v9.0 (in Microsoft.Office.Tools.Excel.v9.0.dll)

Syntax

Public Property DataMember As String

Dim instance As ListObject
Dim value As String

value = instance.DataMember

instance.DataMember = value

public string DataMember { get; set; }

Eigenschaftenwert

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

Berechtigungen

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-Klasse

ListObject-Member

Microsoft.Office.Tools.Excel-Namespace

Freigeben über