DataGridView.DataMember プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ソース:

DataGridView.cs

DataGridViewがデータを表示しているデータ ソース内のリストまたはテーブルの名前を取得または設定します。

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がデータを表示するDataGridView内のテーブルまたはリストの名前。 既定値は Empty です。

例外

Exception

データ ソースでエラーが発生し、 DataError イベントのハンドラーが存在しないか、ハンドラーによって ThrowException プロパティが trueに設定されました。 例外オブジェクトは通常、 FormatException型にキャストできます。

例

次のコード例は、このプロパティの一般的な使用方法を示しています。 この例では、DataGridViewという名前のcustomersDataGridView コントロールが、DataSetという名前のcustomersDataSetにバインドされています。 この DataSet には、"Customers" という名前のテーブルが含まれています。 DataMember プロパティは、テーブルの名前に設定されます。

private void BindData()
{
    customersDataGridView.AutoGenerateColumns = true;
    customersDataGridView.DataSource = customersDataSet;
    customersDataGridView.DataMember = "Customers";
}

Private Sub BindData()

    With customersDataGridView
        .AutoGenerateColumns = True
        .DataSource = customersDataSet
        .DataMember = "Customers"
    End With

End Sub

注釈

このプロパティは、複数のリストまたはテーブルを含むデータ ソースにバインドする場合に便利です。 1 つのリストまたはテーブルを含むデータ ソースにバインドする場合は、このプロパティを設定する必要はありません。 たとえば、このプロパティを設定せずに、1 つのテーブルを含むDataGridViewにDataSet コントロールをバインドできます。 ただし、 DataSet に複数のテーブルが含まれている場合は、このプロパティをいずれかのテーブルの名前に設定する必要があります。

こちらもご覧ください

• DataSource
• DataSet
• DataGridView コントロール (Windows フォーム)