DataGrid.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 die spezifische Liste in einer DataSource Liste ab, für die das DataGrid Steuerelement ein Raster anzeigt, oder legt diese fest.
public:
property System::String ^ DataMember { System::String ^ get(); void set(System::String ^ value); };public string DataMember { get; set; }member this.DataMember : string with get, setPublic Property DataMember As StringEigenschaftswert
Eine Liste in einer DataSource. Der Standardwert ist eine leere Zeichenfolge ("").
Beispiele
Im folgenden Codebeispiel werden die Eigenschaften DataMember und Eigenschaften DataSource eines System.Windows.Forms.DataGrid Steuerelements festgelegt.
protected:
Object^ source;
private:
void SetSourceAndMember()
{
DataSet^ myDataSet = gcnew DataSet( "myDataSet" );
DataTable^ tableCustomers = gcnew DataTable( "Customers" );
myDataSet->Tables->Add( tableCustomers );
// Insert code to populate the DataSet.
// Set DataSource and DataMember with SetDataBinding method.
String^ member;
// The name of a DataTable is Customers.
member = "Customers";
dataGrid1->SetDataBinding( myDataSet, member );
}
protected object source;
private void SetSourceAndMember(){
DataSet myDataSet = new DataSet("myDataSet");
DataTable tableCustomers = new DataTable("Customers");
myDataSet.Tables.Add(tableCustomers);
// Insert code to populate the DataSet.
// Set DataSource and DataMember with SetDataBinding method.
string member;
// The name of a DataTable is Customers.
member = "Customers";
dataGrid1.SetDataBinding(myDataSet, member);
}
Private Sub SetSourceAndMember()
Dim myDataSet As DataSet = New DataSet("myDataSet")
Dim customersTable As DataTable = new DataTable("Customers")
' Insert code to set source to populate DataSet.
' Set DataSource and DataMember with SetDataBinding method.
Dim member As String
' The name of a DataTable is Customers.
member = "Customers"
DataGrid1.SetDataBinding(myDataSet, member)
End Sub
Hinweise
Wenn eine DataSource Datei mehrere Datenquellen enthält, sollten Sie den DataMember Wert auf eine der Quellen festlegen. Wenn es DataSource sich z. B. um eine DataSet oder DataViewManager drei Tabellen mit dem Namen Customers", Ordersund OrderDetails" handelt, müssen Sie eine der Tabellen angeben, an die eine Bindung hergestellt werden soll. Wenn das DataSet oder DataViewManager nur eins DataTableenthält, sollten Sie den DataMember Wert auf dieses TableNameDataTableFestlegen festlegen.
Wenn der DataSource Wert auf ein DataSet Objekt DataRelation festgelegt ist, werden übergeordnete Tabellen in jeder Zeilenüberschrift mit einem Pluszeichen (+) angezeigt. Wenn Sie auf das Pluszeichen klicken, wird ein Knoten angezeigt, der Verknüpfungen zu untergeordneten Tabellen enthält. Wenn z. B. ein Objekt DataSet zwei benannte Customers Objekte enthält und Ordersdas Festlegen der DataMemberCustomers Tabelle bewirkt, dass eine System.Windows.Forms.DataGrid übergeordnete Tabelle mit einem Pluszeichen angezeigt wird, das in jeder Zeilenüberschrift DataTable sichtbar ist. Wenn dies DataMember jedoch auf Orders"Leer" festgelegt ist, sind die Zeilenüberschriften leer.
Wenn es sich DataSource um eine DataTable, eine Auflistung DataViewoder ein Array handelt, löst das Festlegen der DataMember Eigenschaft eine Ausnahme aus.
Hinweis
Zur Laufzeit müssen Sie die SetDataBinding Methode verwenden, um die DataSource Eigenschaft zurückzusetzen. Die DataMember Eigenschaft allein kann jedoch jederzeit auf einen gültigen Tabellennamen zurückgesetzt werden.
