DataGrid.DataMember Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta l'elenco specifico in un oggetto DataSource per il quale il controllo DataGrid visualizza una griglia.

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

Valore della proprietà

String

Elenco in un oggetto DataSource. Il valore predefinito è una stringa vuota ("").

Esempio

Nell'esempio di codice seguente vengono impostate le DataSource proprietà e DataMember di un System.Windows.Forms.DataGrid controllo .

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

Commenti

Se un DataSource oggetto contiene più origini di dati, è necessario impostare su DataMember una delle origini. Ad esempio, se è DataSource o DataSet DataViewManager che contiene tre tabelle denominate Customers, Orderse OrderDetails, è necessario specificare una delle tabelle a cui eseguire l'associazione. DataSet Se o DataViewManager contiene un DataTablesolo oggetto , è necessario impostare l'oggetto DataMember su TableName di tale DataTableoggetto .

Se è DataSource impostato su un oggetto DataSet contenente DataRelation oggetti , le tabelle padre verranno visualizzate con un segno più (+) in ogni intestazione di riga. Facendo clic sul segno più viene visualizzato un nodo contenente collegamenti alle tabelle figlio. Ad esempio, se un DataSet oggetto contiene due DataTable oggetti denominati Customers e Orders, l'impostazione dell'oggetto sulla DataMember tabella determina System.Windows.Forms.DataGrid la Customers visualizzazione di una tabella padre con un segno più visibile in ogni intestazione di riga. Se l'oggetto DataMember è impostato su Orders, tuttavia, le intestazioni di riga saranno vuote.

DataSource Se è un DataTableoggetto , DataView, una raccolta o una matrice, l'impostazione della DataMember proprietà genera un'eccezione.

Nota

In fase di esecuzione, è necessario utilizzare il SetDataBinding metodo per reimpostare la DataSource proprietà. Tuttavia, la DataMember sola proprietà può essere reimpostata in qualsiasi momento su un nome di tabella valido.

Si applica a

Vedi anche