DataGrid.DataMember Propriété

  • Référence

Définition

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

Obtient ou définit la liste spécifique dans DataSource pour laquelle le contrôle DataGrid affiche une grille.

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

Liste dans DataSource. La valeur par défaut est une chaîne vide ("").

Exemples

L’exemple de code suivant définit les propriétés et DataMember les DataSource propriétés d’un System.Windows.Forms.DataGrid contrôle.

protected:
   Object^ source;

private:
   void SetSourceAndMember()
   {
      DataSet^ myDataSet = gcnew DataSet( "myDataSet" );
      DataTable^ tableCustomers = gcnew DataTable( "Customers" );
      myDataSet->Tables->Add( tableCustomers );
      // Insert code to populate the DataSet.

      // Set DataSource and DataMember with SetDataBinding method.
      String^ member;
      
      // The name of a DataTable is Customers.
      member = "Customers";
      dataGrid1->SetDataBinding( myDataSet, member );
   }

protected object source;

private void SetSourceAndMember(){

   DataSet myDataSet = new DataSet("myDataSet");
   DataTable tableCustomers = new DataTable("Customers");
   myDataSet.Tables.Add(tableCustomers);
   // Insert code to populate the DataSet.

   // Set DataSource and DataMember with SetDataBinding method.
   string member;
   // The name of a DataTable is Customers.
   member = "Customers";
   dataGrid1.SetDataBinding(myDataSet, member);
}

Private Sub SetSourceAndMember()
    Dim myDataSet As DataSet = New DataSet("myDataSet")
    Dim customersTable As DataTable = new DataTable("Customers")
    ' Insert code to set source to populate DataSet.
    
    ' Set DataSource and DataMember with SetDataBinding method.
    Dim member As String
    ' The name of a DataTable is Customers.
    member = "Customers"
    DataGrid1.SetDataBinding(myDataSet, member)
 End Sub

Remarques

Si un DataSource contient plusieurs sources de données, vous devez définir l’une DataMember des sources. Par exemple, si l’élément DataSource est un DataSet ou DataViewManager qui contient trois tables nommées Customers, Orderset OrderDetails, vous devez spécifier l’une des tables à lier. Si le DataSet ou DataViewManager ne contient qu’un DataTableseul , vous devez définir la DataMember valeur sur celle-ci TableName DataTable.

Si la DataSource valeur est définie sur un DataSet objet qui contient des DataRelation objets, les tables parentes apparaissent avec un signe plus (+) dans chaque en-tête de ligne. Le fait de cliquer sur le signe plus entraîne l’affichage d’un nœud qui contient des liens vers des tables enfants. Par exemple, si un DataSet contient deux DataTable objets nommés Customers et Orders, la définition de la DataMember Customers table entraîne l’affichage System.Windows.Forms.DataGrid d’une table parente avec un signe plus visible sur chaque en-tête de ligne. Si la DataMember valeur est définie Orders, toutefois, les en-têtes de ligne sont vides.

Si la DataSource valeur est un tableau, DataViewune collection ou une DataTablecollection, la définition de la DataMember propriété lève une exception.

Notes

Au moment de l’exécution, vous devez utiliser la SetDataBinding méthode pour réinitialiser la DataSource propriété. Toutefois, la DataMember propriété seule peut être réinitialisée à tout moment sur un nom de table valide.

S’applique à

Voir aussi