DataGrid.DataMember Özellik

Tanım

Denetimin bir kılavuz görüntülediği DataSource belirli listeyi DataGrid alır veya ayarlar.

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

Özellik Değeri

içindeki bir DataSourceliste. Varsayılan değer boş bir dizedir ("").

Örnekler

Aşağıdaki kod örneği bir DataSource denetimin DataMember ve System.Windows.Forms.DataGrid özelliklerini ayarlar.

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

Açıklamalar

birden DataSource çok veri kaynağı içeriyorsa, öğesini kaynaklardan birine ayarlamanız DataMember gerekir. Örneğin , DataSource ve DataSetadlı DataViewManagerCustomersüç tablo içeren bir Orders veya OrderDetails ise, bağlanılacak tablolardan birini belirtmeniz gerekir. DataSet veya DataViewManager yalnızca bir DataTabletane içeriyorsa değerini olarak DataMemberayarlamanız TableNameDataTable gerekir.

DataSource nesneleri içeren DataSet bir DataRelation olarak ayarlanırsa, üst tablolar her satır üst bilgisinde artı işareti (+) ile görüntülenir. Artı işaretine tıklanması, alt tablolara bağlantılar içeren bir düğümün görünmesine neden olur. Örneğin, bir DataSet öğesi ve DataTableadlı Customers iki Orders nesne içeriyorsa, öğesinin tablo olarak ayarlanmasıDataMember, öğesinin CustomersSystem.Windows.Forms.DataGrid her satır üst bilgisinde artı işareti görünen bir üst tablo görüntülemesine neden olur. ancak olarak DataMember ayarlanırsa Orders, satır üst bilgileri boş olur.

DataSource bir , DataTable, koleksiyonu veya dizisiyseDataView, özelliğini ayarlamak DataMember bir özel durum oluşturur.

Note

Çalışma zamanında özelliğini sıfırlamak SetDataBinding için yöntemini kullanmanız DataSource gerekir. Ancak özellik DataMember tek başına herhangi bir zamanda geçerli bir tablo adına sıfırlanabilir.

Şunlara uygulanır

Ayrıca bkz.