DataGrid.DataMember 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取得或設定 DataSource 中的特定清單，DataGrid 控制項將使用方格顯示這個清單。

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

屬性值

String

DataSource 中的清單。 預設為空字串 ("")。

範例

下列程式碼範例會設定 DataSource 控制項的 System.Windows.Forms.DataGrid 和 DataMember 屬性。

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

備註

DataSource如果 包含多個資料來源，您應該將 DataMember 設定為其中一個來源。 例如，如果 DataSource 是 DataSet 或 DataViewManager ，其中包含三個名為 Customers 、 Orders 和 OrderDetails 的資料表，則必須指定要系結的其中一個資料表。 DataSet如果 或 DataViewManager 只包含一個 DataTable ，您應該將 DataMember 設定為 TableName 該 DataTable 的 。

DataSource如果 設定為 DataSet 包含 DataRelation 物件的 ，則父資料表會顯示每個資料列標頭中的加號 (+) 。 按一下加號會導致節點出現，其中包含子資料工作表的連結。 例如，如果 DataSet 包含名為 和 Orders 的兩 DataTable 個 Customers 物件，將 設定 DataMember 為 Customers 資料表會導致 System.Windows.Forms.DataGrid 顯示每個資料列標頭上具有加號的父資料表。 DataMember不過，如果 設定 Orders 為 ，則資料列標頭會是空白的。

DataSource如果 是 DataTable 、、 DataView 集合或陣列，則設定 DataMember 屬性會擲回例外狀況。

注意

在執行時間，您必須使用 SetDataBinding 方法來重設 DataSource 屬性。 不過， DataMember 屬性本身可以隨時重設為有效的資料表名稱。

另請參閱

• DataSource
• DataSet
• DataViewManager
• SetDataBinding(Object, String)