DataGridView.DataMember プロパティ

.NET Framework クラス ライブラリ リファレンス

DataGridView.DataMember プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

DataGridView でデータが表示される対象のデータ ソースのリストまたはテーブルの名前を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property DataMember As
 String

Visual Basic (使用法)

Dim instance As DataGridView
Dim value As String

value = instance.DataMember

instance.DataMember = value

C#

public string DataMember { get;
 set; }

C++

public:
property String^ DataMember {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_DataMember ()

/** @property */
public void set_DataMember (String value)

JScript

public function get DataMember
 () : String

public function set DataMember
 (value : String)

プロパティ値
DataGridView でデータが表示される対象の DataSource のテーブルまたはリストの名前。既定値は Empty です。

例外

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

解説

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

使用例

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
DataSource
DataSet
その他の技術情報
DataGridView コントロール (Windows フォーム)