次の方法で共有

DataGrid.DataMember プロパティ

  • [アーティクル]

System.Windows.Forms.DataGrid コントロールでグリッドを表示するための、 DataSource 内の特定のリストを取得または設定します。

Public Property DataMember As String
[C#]
public string DataMember {get; set;}
[C++]
public: __property String* get_DataMember();public: __property void set_DataMember(String*);
[JScript]
public function get DataMember() : String;public function set DataMember(String);

プロパティ値

DataSource のリスト。既定値は空の文字列 ("") です。

解説

DataSource で複数のソース データを格納している場合は、 DataMember をソースのいずれかに設定します。たとえば、 DataSource が DataSet または DataViewManager であり、Customers、Orders、および OrderDetails という名前の 3 つのテーブルを格納している場合は、バインド先のテーブルを 1 つ指定する必要があります。 DataSet または DataViewManager が DataTable を 1 つだけ格納している場合は、 DataMember をその DataTable の TableName に設定する必要があります。

DataSource が DataRelation オブジェクトを格納している DataSet に設定されている場合、各行ヘッダーにプラス記号 (+) が付いた親テーブルが表示されます。プラス記号をクリックすると、子テーブルへのリンクを保持するノードが表示されます。たとえば、 DataSet が Customers と Orders という名前の 2 つの DataTable オブジェクトを格納している場合は、 DataMember を Customers テーブルに設定すると、 System.Windows.Forms.DataGrid で各行ヘッダーにプラス記号が付いた親テーブルが表示されます。ただし、 DataMember が Orders に設定されている場合、行ヘッダーは空白になります。

DataSource が DataTable 、 DataView 、コレクション、または配列の場合は、 DataMember プロパティを設定すると、例外がスローされます。

メモ   実行時に DataSource プロパティをリセットするには、 SetDataBinding メソッドを使用する必要があります。ただし、 DataMember プロパティだけはいつでも有効なテーブル名にリセットできます。

使用例

[Visual Basic, C#, C++] System.Windows.Forms.DataGrid コントロールの DataSource プロパティおよび DataMember プロパティを設定する例を次に示します。

 
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


[C#] 
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);
}


[C++] 
protected:
Object* source;

private:
void SetSourceAndMember(){

   DataSet* myDataSet = new DataSet(S"myDataSet");
   DataTable* tableCustomers = new DataTable(S"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 = S"Customers";
   dataGrid1->SetDataBinding(myDataSet, member);
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

DataGrid クラス | DataGrid メンバ | System.Windows.Forms 名前空間 | DataSource | DataSet | DataViewManager | SetDataBinding