DataGrid.DataMember Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает определенный список в свойстве DataSource, для которого элемент управления DataGrid отображает сетку.

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

Значение свойства

String

Список в DataSource. Значение по умолчанию — пустая строка ("").

Примеры

В следующем примере кода задаются DataSource и DataMember свойства System.Windows.Forms.DataGrid элемента управления.

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

Комментарии

Если объект DataSource содержит несколько источников данных, следует задать DataMember один из источников. Например, если DataSource объект является DataSet или DataViewManager содержит три таблицы с именем Customers, Ordersи OrderDetailsнеобходимо указать одну из таблиц для привязки. DataSet Если объект или DataViewManager содержит только одинDataTable, следует задать для этого DataTableзначение DataMember TableName.

DataSource Если задано значение, DataSet содержащее DataRelation объекты, родительские таблицы будут отображаться со знаком "плюс" (+) в каждом заголовке строки. Нажатие знака "плюс" приводит к отображению узла, содержащего ссылки на дочерние таблицы. Например, если DataSet объект содержит два DataTable именованных Customers объекта, а Ordersпараметр DataMember Customers таблицы приводит System.Windows.Forms.DataGrid к отображению родительской таблицы со знаком "плюс", видимым для каждого заголовка строки. DataMember Однако если задано значение Orders, заголовки строк будут пустыми.

DataSource Если свойство имеет тип DataTable, DataViewколлекцию или массив, свойство DataMember создает исключение.

Примечание

Во время выполнения необходимо использовать SetDataBinding метод для сброса DataSource свойства. DataMember Однако свойство можно в любое время сбросить до допустимого имени таблицы.

См. также раздел

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