Udostępnij za pośrednictwem

DataGrid.DataMember Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia określoną listę na DataSource liście, dla której kontrolka DataGrid wyświetla siatkę.

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

Wartość właściwości

String

Lista w elemecie DataSource. Wartością domyślną jest ciąg pusty ("").

Przykłady

Poniższy przykład kodu ustawia DataSource właściwości i DataMember kontrolki System.Windows.Forms.DataGrid .

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

Uwagi

Jeśli element DataSource zawiera wiele źródeł danych, należy ustawić wartość DataMember na jedno ze źródeł. Jeśli na przykład element DataSource jest tabelą DataSet lub DataViewManager zawierającą trzy tabele o nazwie Customers, Ordersi OrderDetails, należy określić jedną z tabel, z którymi ma zostać powiązana. Jeśli właściwość DataSet lub DataViewManager zawiera tylko jeden DataTableelement , należy ustawić wartość DataMember na TableName wartość .DataTable

DataSource Jeśli właściwość jest ustawiona na DataSet obiekt zawierający DataRelation obiekty, tabele nadrzędne będą wyświetlane z znakiem plus (+) w każdym nagłówku wiersza. Kliknięcie znaku plus powoduje wyświetlenie węzła zawierającego łącza do tabel podrzędnych. Jeśli na przykład obiekt DataSet zawiera dwa DataTable obiekty o nazwie Customers i Orders, ustawienie Customers DataMember dla tabeli powoduje System.Windows.Forms.DataGrid wyświetlenie tabeli nadrzędnej z znakiem plus widocznym w każdym nagłówku wiersza. DataMember Jeśli parametr ma wartość Orders, nagłówki wierszy będą jednak puste.

Jeśli element DataSource to DataTable, DataView, kolekcja lub tablica, ustawienie DataMember właściwości zgłasza wyjątek.

Uwaga

W czasie wykonywania należy użyć SetDataBinding metody , aby zresetować DataSource właściwość . DataMember Jednak sama właściwość może zostać zresetowana w dowolnym momencie do prawidłowej nazwy tabeli.

Dotyczy

Zobacz też