DataGrid.DataMember Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGrid.cs

Získá nebo nastaví konkrétní seznam, DataSource pro který DataGrid ovládací prvek zobrazí mřížku.

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

Hodnota vlastnosti

String

Seznam v souboru DataSource. Výchozí hodnota je prázdný řetězec ("").

Příklady

Následující příklad kódu nastaví DataSource a DataMember vlastnosti System.Windows.Forms.DataGrid ovládacího prvku.

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

Poznámky

DataSource Pokud obsahuje více zdrojů dat, měli byste nastavit DataMember jeden ze zdrojů. Pokud DataSource je například tabulka DataViewManager nebo DataSet která obsahuje tři tabulky s názvem Customers, Ordersa OrderDetails, musíte zadat jednu z tabulek, ke kterým se má vytvořit vazba. Pokud nebo DataSetDataViewManager obsahuje pouze jeden DataTable, měli byste nastavit DataMember na TableName hodnotu DataTabletohoto .

Pokud je nastavená DataSource na DataSetDataRelation objekty, zobrazí se nadřazené tabulky se znaménkem plus (+) v záhlaví každého řádku. Kliknutí na znaménko plus způsobí zobrazení uzlu, který obsahuje odkazy na podřízené tabulky. Pokud například DataSet obsahuje dva DataTable pojmenované objekty Customers a Ordersnastavení DataMember tabulky Customers způsobí System.Windows.Forms.DataGrid zobrazení nadřazené tabulky se znaménkem plus viditelným v záhlaví každého řádku. DataMember Pokud je ale nastavená hodnota Orders, záhlaví řádků budou prázdná.

Pokud je vlastnost DataSourceDataTable, , DataViewkolekce nebo pole, nastavení DataMember vlastnosti vyvolá výjimku.

Poznámka:

Za běhu je nutné použít metodu SetDataBinding k resetování DataSource vlastnosti. Samotná DataMember vlastnost však může být kdykoli resetovat na platný název tabulky.

Viz také

• DataSource
• DataSet
• DataViewManager
• SetDataBinding(Object, String)