DataGrid.SetDataBinding メソッドとは何？わかりやすく解説 Weblio辞書

.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)

public void SetDataBinding (
    Object dataSource,
    string dataMember
)

C++

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

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

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" );
   }

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