DataGrid.SetDataBinding メソッド

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

DataGrid.SetDataBinding メソッド

実行時に DataSource プロパティと DataMember プロパティを設定します。

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

Visual Basic (宣言)

Public Sub SetDataBinding ( _
    dataSource As Object, _
    dataMember As String _
)

Visual Basic (使用法)

Dim instance As DataGrid
Dim dataSource As Object
Dim dataMember As String

instance.SetDataBinding(dataSource, dataMember)

C#

public void SetDataBinding (
    Object dataSource,
    string dataMember
)

C++

public:
void SetDataBinding (
    Object^ dataSource, 
    String^ dataMember
)

J#

public void SetDataBinding (
    Object dataSource, 
    String dataMember
)

JScript

public function SetDataBinding (
    dataSource : Object, 
    dataMember : String
)

パラメータ

dataSource

System.Windows.Forms.DataGrid コントロールのデータ ソース。

dataMember

DataSource プロパティによって返されたオブジェクト内で、バインド先のテーブルを指定する DataMember 文字列。

例外

例外の種類	条件
ArgumentException	1 つ以上の引数が無効です。
ArgumentNullException	dataSource 引数が null 参照 (Visual Basic では Nothing) です。

解説

実行時に SetDataBinding メソッドを使用して、DataSource プロパティをリセットする必要があります。

有効なデータ ソースを設定する方法の詳細については、DataSource プロパティのトピックを参照してください。

作成したグリッドで、ユーザーはデータを編集できるが、新しい行を追加できないようにするには、DataView をデータ ソースとして使用し、AllowNew プロパティを false に設定します。DataSource が DataView または DataTable の場合は、DataMember を空の文字列 ("") に設定します。

使用例

DataSource を DataSet に設定し、DataMember を、その DataSet 内の DataTable に設定するコード例を次に示します。

Visual Basic

Private Sub BindControls()
    ' Create a DataSet named SuppliersProducts.
    Dim SuppliersProducts As New
 DataSet("SuppliersProducts")
    ' Adds two DataTable objects, Suppliers and Products.
    SuppliersProducts.Tables.Add(New DataTable("Suppliers"))
    SuppliersProducts.Tables.Add(New DataTable("Products"))
    ' Insert code to add DataColumn objects.
    ' Insert code to fill tables with columns and data.
    ' Binds the DataGrid to the DataSet, displaying the Suppliers table.
    dataGrid1.SetDataBinding(SuppliersProducts, "Suppliers")
End Sub 'BindControls

C#

private void BindControls(){
    // Creates a DataSet named SuppliersProducts.
    DataSet SuppliersProducts = new DataSet("SuppliersProducts");
    // Adds two DataTable objects, Suppliers and Products.
    SuppliersProducts.Tables.Add(new DataTable("Suppliers"));
    SuppliersProducts.Tables.Add(new DataTable("Products"));
    // Insert code to add DataColumn objects.
    // Insert code to fill tables with columns and data.
    // Binds the DataGrid to the DataSet, displaying the Suppliers table.
    dataGrid1.SetDataBinding(SuppliersProducts, "Suppliers");
 }
   

C++

private:
   void BindControls()
   {
      // Creates a DataSet named SuppliersProducts.
      DataSet^ SuppliersProducts = gcnew DataSet( "SuppliersProducts" );
      // Adds two DataTable objects, Suppliers and Products.
      SuppliersProducts->Tables->Add( gcnew DataTable( "Suppliers"
 ) );
      SuppliersProducts->Tables->Add( gcnew DataTable( "Products"
 ) );
      // Insert code to add DataColumn objects.
      // Insert code to fill tables with columns and data.
      // Binds the DataGrid to the DataSet, displaying the Suppliers
 table.
      dataGrid1->SetDataBinding( SuppliersProducts, "Suppliers" );
   }

J#

private void BindControls()
{
    // Creates a DataSet named SuppliersProducts.
    DataSet suppliersProducts = new DataSet("SuppliersProducts");
    // Adds two DataTable objects, Suppliers and Products.
    suppliersProducts.get_Tables().Add(new DataTable("Suppliers"));
    suppliersProducts.get_Tables().Add(new DataTable("Products"));
    // Insert code to add DataColumn objects.
    // Insert code to fill tables with columns and data.
    // Binds the DataGrid to the DataSet, displaying the Suppliers table.
    dataGrid1.SetDataBinding(suppliersProducts, "Suppliers");
} //BindControls

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0

参照

関連項目
DataGrid クラス
DataGrid メンバ
System.Windows.Forms 名前空間
DataMember
DataSource
DataSet
DataView