DataGridView.DataMember Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает имя списка или таблицы в источнике данных, для которого объект 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
Значение свойства
Имя таблицы или списка в свойстве DataSource, для которого объект DataGridView является отображением данных. Значение по умолчанию — Empty.
Исключения
Произошла ошибка в источнике данных, и нет обработчика для события 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 Однако если содержит несколько таблиц, необходимо задать для этого свойства имя одной из таблиц.