Sdílet prostřednictvím

DataGrid.DataMember Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

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 .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 DataSet například tabulka nebo DataViewManager která obsahuje tři tabulky s názvem Customers, Ordersa OrderDetailsmusíte zadat jednu z tabulek, ke kterým se má vytvořit vazba. Pokud nebo DataSet DataViewManager obsahuje pouze jeden DataTable, měli byste nastavit DataMember na TableName hodnotu DataTabletéto .

DataSource Pokud je nastavena DataSet na objektyDataRelation, zobrazí se nadřazené tabulky se znaménkem plus (+) v záhlaví každého řádku. Kliknutím na znaménko plus se zobrazí uzel, který obsahuje odkazy na podřízené tabulky. Pokud například DataSet obsahuje dva DataTable objekty pojmenované 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. Pokud je však nastavena DataMember na Ordershodnotu , záhlaví řádků budou prázdná.

Pokud je hodnota DataSource DataTable, kolekce DataViewnebo 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 se ale může kdykoli obnovit na platný název tabulky.

Platí pro

Viz také