共用方式為


DataGrid.DataMember 屬性

定義

取得或設定 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.DataGridDataMember 屬性。

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 設定為其中一個來源。 例如,如果 DataSourceDataSetDataViewManager ,其中包含三個名為 CustomersOrdersOrderDetails 的資料表,則必須指定要系結的其中一個資料表。 DataSet如果 或 DataViewManager 只包含一個 DataTable ,您應該將 DataMember 設定為 TableNameDataTable 的 。

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

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

注意

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

適用於

另請參閱