DataGrid.DataMember Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGrid.cs

Возвращает или задает определенный список, для 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необходимо указать одну из таблиц для привязки. Если он DataSetDataViewManager содержит только один DataTable, следует задать DataMember для TableName этого DataTableзначение.

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)