DataGridView.DataMember Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtient ou définit le nom de la liste ou de la table dans la source de données pour laquelle le DataGridView affiche des données.

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

Valeur de propriété

String

Nom de la table ou de la liste dans la DataSource pour laquelle le DataGridView affiche des données. La valeur par défaut est Empty.

Exceptions

Exception

Une erreur s’est produite dans la source de données, et il n’existe pas de gestionnaire pour l’événement DataError ou le gestionnaire a défini la propriété ThrowException sur true. L’objet d’exception peut généralement être casté en type FormatException.

Exemples

L’exemple de code suivant illustre une utilisation courante de cette propriété. Dans l’exemple, un DataGridView contrôle nommé customersDataGridView est lié à un DataSet nommé customersDataSet. Il DataSet contient une table nommée « Clients ». La DataMember propriété est définie sur le nom de la table.

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

Remarques

Cette propriété est utile lors de la liaison à une source de données qui contient plusieurs listes ou tables. Vous n’avez pas besoin de définir cette propriété lors de la liaison à une source de données qui contient une liste ou une table unique. Par exemple, vous pouvez lier un DataGridView contrôle à un DataSet qui contient une table unique sans définir cette propriété. Toutefois, si le DataSet contient plusieurs tables, vous devez définir cette propriété sur le nom de l’une des tables.

S’applique à

Voir aussi