DataGridView.DataMember Propriété

Définition

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.Gets or sets the name of the list or table in the data source for which the DataGridView is displaying data.

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é

Nom de la table ou de la liste dans la DataSource pour laquelle le DataGridView affiche des données.The name of the table or list in the DataSource for which the DataGridView is displaying data. La valeur par défaut est Empty.The default is Empty.

Exceptions

Une erreur s’est produite dans la source de données et il n’existe aucun gestionnaire pour l’événement DataError ou le gestionnaire a défini la propriété ThrowException avec la valeur true.An error occurred in the data source and either there is no handler for the DataError event or the handler has set the ThrowException property to true. L’objet exception peut généralement être converti en type FormatException.The exception object can typically be cast to type FormatException.

Exemples

L’exemple de code suivant illustre une utilisation courante de cette propriété.The following code example illustrates a common use for this property. Dans l’exemple, un contrôle DataGridView nommé customersDataGridView est lié à un DataSet nommé customersDataSet.In the example, a DataGridView control named customersDataGridView is bound to a DataSet named customersDataSet. Ce DataSet contient une table nommée « Customers ».This DataSet contains a table named "Customers". La propriété DataMember est définie sur le nom de la table.The DataMember property is set to the name of the 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.This property is useful when binding to a data source that contains multiple lists or 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.You do not need to set this property when binding to a data source that contains a single list or table. Par exemple, vous pouvez lier un contrôle DataGridView à un DataSet qui contient une table unique sans définir cette propriété.For example, you can bind a DataGridView control to a DataSet that contains a single table without setting this property. Toutefois, si le DataSet contient plusieurs tables, vous devez définir cette propriété sur le nom de l’une des tables.If the DataSet contains multiple tables, however, you must set this property to the name of one of the tables.

S’applique à

Voir aussi