DataGridView.DataMember Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает имя списка или таблицы в источнике данных, для которого объект DataGridView является отображением данных.

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, для которого объект DataGridView является отображением данных. Значение по умолчанию — Empty.

Исключения

Exception

Произошла ошибка в источнике данных, и нет обработчика для события DataError, или обработчик задал для свойства ThrowException значение true. Объект исключения обычно можно привести к типу FormatException.

Примеры

В следующем примере кода показано частое использование этого свойства. В этом примере DataGridView элемент управления с именем customersDataGridView привязан к объекту DataSet с именем customersDataSet. Содержит DataSet таблицу с именем "Клиенты". Свойству DataMember присваивается имя таблицы.

private void BindData()
{
    customersDataGridView.AutoGenerateColumns = true;
    customersDataGridView.DataSource = customersDataSet;
    customersDataGridView.DataMember = "Customers";
}

Private Sub BindData()

    With customersDataGridView
        .AutoGenerateColumns = True
        .DataSource = customersDataSet
        .DataMember = "Customers"
    End With

End Sub

Комментарии

Это свойство полезно при привязке к источнику данных, содержащему несколько списков или таблиц. Это свойство не нужно задавать при привязке к источнику данных, содержащему один список или таблицу. Например, можно привязать DataGridView элемент управления к объекту , DataSet который содержит одну таблицу, не задавая это свойство. DataSet Однако если содержит несколько таблиц, необходимо задать для этого свойства имя одной из таблиц.

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

• DataSource
• DataSet
• элемент управления DataGridView (Windows Forms)