DataGridView.DataMember Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o nome da lista ou da tabela na fonte de dados para a qual o DataGridView está exibindo 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 da propriedade

String

O nome da tabela ou lista no DataSource para que o DataGridView está exibindo dados. O padrão é Empty.

Exceções

Exception

Ocorreu um erro na fonte de dados e não há nenhum manipulador para o evento DataError ou o manipulador definiu a propriedade ThrowException como true. Normalmente, o objeto de exceção pode ser convertido para o tipo FormatException.

Exemplos

O exemplo de código a seguir ilustra um uso comum para essa propriedade. No exemplo, um DataGridView controle chamado customersDataGridView é associado a um DataSet nomeado customersDataSet. Isso DataSet contém uma tabela chamada "Clientes". A DataMember propriedade é definida como o nome da tabela.

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

Comentários

Essa propriedade é útil ao associar a uma fonte de dados que contém várias listas ou tabelas. Você não precisa definir essa propriedade ao associar a uma fonte de dados que contém uma única lista ou tabela. Por exemplo, você pode associar um DataGridView controle a um DataSet que contém uma única tabela sem definir essa propriedade. No entanto, se o DataSet contiver várias tabelas, você deverá definir essa propriedade como o nome de uma das tabelas.

Confira também

• DataSource
• DataSet
• Controle DataGridView (Windows Forms)