DataGrid.DataMember Eigenschaft

Definition

Ruft die angegebene Liste in einer DataSource ab, für die das DataGrid-Steuerelement ein Datenblatt anzeigt, oder legt diese fest.Gets or sets the specific list in a DataSource for which the DataGrid control displays a grid.

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

Eine Liste in einer DataSource.A list in a DataSource. Der Standardwert ist eine leere Zeichenfolge ("").The default is an empty string ("").

Beispiele

Im folgenden Codebeispiel werden die Eigenschaften DataSource und DataMember eines System.Windows.Forms.DataGrid-Steuer Elements festgelegt.The following code example sets the DataSource and DataMember properties of a System.Windows.Forms.DataGrid control.

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 mehrere Datenquellen enthält, sollten Sie die DataMember auf eine der Quellen festlegen.If a DataSource contains multiple sources of data, you should set the DataMember to one of the sources. Wenn die DataSource beispielsweise ein DataSet oder DataViewManager ist, das drei Tabellen mit den Namen Customers, Orders und OrderDetails enthält, müssen Sie eine der Tabellen angeben, an die die Bindung erfolgen soll.For example, if the DataSource is a DataSet or DataViewManager that contains three tables named Customers, Orders, and OrderDetails, you must specify one of the tables to bind to. Wenn die DataSet oder DataViewManager nur eine DataTable enthält, sollten Sie die DataMember auf die TableName dieser DataTable festlegen.If the DataSet or DataViewManager contains only one DataTable, you should set the DataMember to the TableName of that DataTable.

Wenn die DataSource auf einen DataSet festgelegt ist, der DataRelation-Objekte enthält, werden die übergeordneten Tabellen in jedem Zeilen Header mit einem Pluszeichen (+) angezeigt.If the DataSource is set to a DataSet that contains DataRelation objects, parent tables will appear with a plus sign (+) in each row header. Wenn Sie auf das Pluszeichen klicken, wird ein Knoten angezeigt, der Links zu untergeordneten Tabellen enthält.Clicking the plus sign causes a node to appear that contains links to child tables. Wenn z. b. ein DataSet zwei DataTable-Objekte mit dem Namen Customers und Orders enthält, bewirkt das Festlegen des DataMember auf die Customers-Tabelle, dass der System.Windows.Forms.DataGrid eine übergeordnete Tabelle mit einem Pluszeichen anzeigt, das für jeden Zeilen Header sichtbar ist.For example, if a DataSet contains two DataTable objects named Customers and Orders, setting the DataMember to the Customers table causes the System.Windows.Forms.DataGrid to display a parent table with a plus sign visible on each row header. Wenn die DataMember auf Orders festgelegt ist, sind die Zeilen Header jedoch leer.If the DataMember is set to Orders, however, the row headers will be blank.

Wenn die DataSource eine DataTable, DataView, Collection oder Array ist, löst das Festlegen der DataMember-Eigenschaft eine Ausnahme aus.If the DataSource is a DataTable, DataView, collection, or array, setting the DataMember property throws an exception.

Hinweis

Zur Laufzeit müssen Sie die SetDataBinding-Methode verwenden, um die Eigenschaft DataSource zurückzusetzen.At run time, you must use the SetDataBinding method to reset the DataSource property. Allerdings kann die Eigenschaft "DataMember" allein jederzeit auf einen gültigen Tabellennamen zurückgesetzt werden.However, the DataMember property alone can be reset at any time to a valid table name.

Gilt für:

Siehe auch