DataGrid.DataMember プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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, setPublic Property DataMember As Stringプロパティ値
DataSource のリスト。 既定値は、空の文字列 ("") です。
例
次のコード例では、コントロールの DataSource プロパティとプロパティ DataMember を 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
注釈
複数のデータ ソースが DataSource 含まれている場合は、いずれかのソースに設定 DataMember する必要があります。 たとえば、a または DataViewManager 3 つのテーブルが含まれている場合DataSourceDataSetは、OrderDetails``OrdersバインドするテーブルCustomersの 1 つを指定する必要があります。 DataSet DataViewManagerまたは 1 つだけDataTableが含まれている場合は、そのDataTableオブジェクトに設定DataMemberするTableName必要があります。
オブジェクトをDataSource含むDataRelationオブジェクトDataSetに設定されている場合、親テーブルは各行ヘッダーにプラス記号 (+) で表示されます。 プラス記号をクリックすると、子テーブルへのリンクを含むノードが表示されます。 たとえば、a に DataSet 2 つのDataTableオブジェクトが含Customersまれている場合、テーブルOrdersにCustomers設定DataMemberするとSystem.Windows.Forms.DataGrid、各行ヘッダーにプラス記号が表示された親テーブルが表示されます。 ただし、この DataMember 値を Orders設定すると、行ヘッダーは空白になります。
DataSourceが 、、DataViewコレクション、または配列のDataTable場合、プロパティを設定するとDataMember例外がスローされます。
注意
実行時に、メソッドを SetDataBinding 使用してプロパティをリセットする DataSource 必要があります。 ただし、 DataMember プロパティだけでは、いつでも有効なテーブル名にリセットできます。