ListObject.DataMember Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den spezifischen Datenmember aus einer Datenquelle mit mehreren Membern ab, der an das ListObject-Steuerelement gebunden werden soll, oder legt diesen Datenmember fest.
public string DataMember { get; set; }
Eigenschaftswert
Ein Datenmember aus einer Datenquelle mit mehreren Membern. Der Standardwert ist Empty.
Beispiele
Im folgenden Codebeispiel wird ein DataSet mit zwei DataTable -Objekten erstellt, und eine der Tabellen wird mit Daten aufgefüllt. Anschließend legt der Code die DataSource -Eigenschaft und die-Eigenschaft DataMember des fest ListObject , um eine Bindung an die Tabelle mit Daten herzustellen.
Dieses Beispiel gilt für eine Anpassung auf Dokument Ebene.
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
Hinweise
Nicht erforderlich, wenn die Datenquelle nur über einen Member verfügt.
Verwenden Sie die- DataMember Eigenschaft, um ein Element aus einer Datenquelle mit mehreren Membern für die Bindung an das-Steuerelement anzugeben ListObject . Wenn Sie z. b. über eine Datenquelle mit mehreren Tabellen verfügen, die in der- DataSource Eigenschaft angegeben ist, verwenden Sie die- DataMember Eigenschaft, um anzugeben, welche Tabelle an das-Steuerelement gebunden werden soll ListObject .