DataGridView.DataMember Propriedade

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Obtém ou define o nome da lista ou tabela na fonte de dados para a qual o DataGridView está a mostrar os dados.

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

Valor de Propriedade

String

O nome da tabela ou lista no DataSource para o qual o DataGridView está a exibir os dados. A predefinição é Empty.

Exceções

Exception

Ocorreu um erro na fonte de dados e ou não existe um handler para o DataError evento ou o handler definiu a ThrowException propriedade para true. O objeto exceção pode tipicamente ser lançado para o tipo FormatException.

Exemplos

O seguinte exemplo de código ilustra um uso comum desta propriedade. No exemplo, um DataGridView controlo nomeado customersDataGridView está ligado a um DataSet nome customersDataSet. Esta DataSet contém uma tabela chamada "Clientes". A DataMember propriedade é definida com o nome da mesa.

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

Observações

Esta propriedade é útil ao ligar a uma fonte de dados que contém múltiplas listas ou tabelas. Não precisa de definir esta propriedade ao ligar a uma fonte de dados que contém uma única lista ou tabela. Por exemplo, pode associar um DataGridView controlo a DataSet a que contenha uma única tabela sem definir essa propriedade. Se o DataSet contiver múltiplas tabelas, no entanto, deve definir esta propriedade para o nome de uma das tabelas.

Aplica-se a

Ver também