DataGrid.SetDataBinding(Object, String) メソッド

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

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

public:
 void SetDataBinding(System::Object ^ dataSource, System::String ^ dataMember);
public void SetDataBinding (object dataSource, string dataMember);
member this.SetDataBinding : obj * string -> unit
Public Sub SetDataBinding (dataSource As Object, dataMember As String)

パラメーター

dataSource
Object

DataGrid コントロールのデータ ソース。

dataMember
String

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

例外

ArgumentException

1 つ以上の引数が無効です。

ArgumentNullException

dataSource 引数が null です。

例

次のコード例では、 DataSource と DataMember をそれぞれ DataSetに設定し、 の を DataTable に DataSet設定します。

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

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

注釈

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

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

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

適用対象

こちらもご覧ください