DataGrid.DataMember Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit la liste spécifique dans laquelle DataSource le DataGrid contrôle 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, setPublic Property DataMember As StringValeur de propriété
Une liste dans un 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’objet 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 TableNameDataTable.
Si la valeur DataSource est définie sur un objet contenant DataRelation des DataSet objets, les tables parentes s’affichent 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 objet contient deux DataTable objets nommés Customers et Orders, la définition de DataMember la 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 l’objet DataSource est un DataTable, une DataViewcollection ou un tableau, la définition de la DataMember propriété lève une exception.
Note
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.
