DataGrid.DataMember Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft die angegebene Liste in einer DataSource ab, für die das DataGrid-Steuerelement ein Datenblatt 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, set
Public Property DataMember As String

Eigenschaftswert

String

Eine Liste in einer DataSource. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Im folgenden Codebeispiel werden die und DataMember die DataSource Eigenschaften 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 dies DataMember auf eine der Quellen festlegen. Wenn DataSource es sich z. B. um eine oder DataViewManager eine DataSet tabelle mit dem Namen Customers", Ordersund OrderDetails" handelt, müssen Sie eine der Tabellen angeben, an die eine Bindung gebunden werden soll. Wenn das DataSet oder DataViewManager nur eins DataTableenthält, sollten Sie dies auf das DataMember TableName DataTablefestlegen.

Wenn der DataSource Wert auf ein DataSet DataRelation Objekt festgelegt ist, werden übergeordnete Tabellen in jeder Zeilenüberschrift mit einem Pluszeichen (+) angezeigt. Durch Klicken auf das Pluszeichen wird ein Knoten angezeigt, der Links zu untergeordneten Tabellen enthält. Wenn z. B. ein DataSet Objekt mit dem Namen Customers und Ordersdem Festlegen der DataMember Customers Tabelle enthältDataTable, wird die System.Windows.Forms.DataGrid übergeordnete Tabelle mit einem Pluszeichen für jede Zeilenüberschrift angezeigt. Wenn der DataMember Wert jedoch auf Orders"Leer" festgelegt ist, sind die Zeilenüberschriften leer.

Wenn es DataSource sich 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. DataMember Die Eigenschaft kann jedoch jederzeit auf einen gültigen Tabellennamen zurückgesetzt werden.

Gilt für

Siehe auch