DataGrid.SetDataBinding メソッド

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

Public Sub SetDataBinding( _
   ByVal dataSource As Object, _   ByVal dataMember As String _)
[C#]
public void SetDataBinding(objectdataSource,stringdataMember);
[C++]
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 をデータ ソースとして使用し、 AddNew プロパティを false に設定します。 DataSource が DataView または DataTable の場合は、 DataMember を空の文字列 ("") に設定します。

使用例

[Visual Basic, C#, C++] DataSource を DataSet に、 DataMember を DataSet の DataTable に設定する例を次に示します。

 
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 = new DataSet(S"SuppliersProducts");
    // Adds two DataTable objects, Suppliers and Products.
    SuppliersProducts->Tables->Add(new DataTable(S"Suppliers"));
    SuppliersProducts->Tables->Add(new DataTable(S"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, S"Suppliers");
}
   

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

DataGrid クラス | DataGrid メンバ | System.Windows.Forms 名前空間 | DataMember | DataSource | DataSet | DataView