次の方法で共有

Binding コンストラクタ

  • [アーティクル]

指定したデータ ソースの指定したデータ メンバに、指定したコントロール プロパティを単純バインドする、 Binding クラスの新しいインスタンスを初期化します。

Public Sub New( _
   ByVal propertyName As String, _   ByVal dataSource As Object, _   ByVal dataMember As String _)
[C#]
public Binding(
   stringpropertyName,objectdataSource,stringdataMember);
[C++]
public: Binding(
   String* propertyName,Object* dataSource,String* dataMember);
[JScript]
public function Binding(
   propertyName : String,dataSource : Object,dataMember : String);

パラメータ

  • propertyName
    バインドするコントロール プロパティの名前。
  • dataSource
    データ ソースを表す Object 。
  • dataMember
    バインド先のプロパティまたはリスト。

例外

例外の種類 条件
Exception propertyName が、コントロールの有効なプロパティでも、空の文字列 ("") でもありません。

解説

データ ソースとして、次のいずれかのクラスのインスタンスを指定できます。

dataMember 文字列の作成方法については、 Binding クラスのトピックを参照してください。

コントロールのプロパティに対するバインディングを作成すると、新しい Binding オブジェクトは、バインド先のコントロールによって公開されるイベントを検査し、2 つのイベントに結び付けます。

存在しないプロパティにバインドしようとすると、 Binding オブジェクトがコントロールの Control.DataBindings コレクションに追加されるときに System.Windows.Forms.System.ArgumentException がスローされます。

使用例

myDataSet という名前の DataSet 内のテーブルの列に、 TextBox コントロールをバインドする例を次に示します。この例では、モジュールの宣言セクションで myDataSet が宣言されていることを前提にしています。

 
Private Sub CreateDataSet
   myDataSet = new DataSet("myDataSet")
   ' Populates the DataSet with tables, relations, and
   ' constraints.
End Sub

Private Sub BindTextBoxToDataSet 
   ' Binds a TextBox control to a column in the DataSet.
   textBox1.DataBindings.Add _
   ("Text", myDataSet, "Suppliers.CompanyName")
End Sub

[C#] 
private void CreateDataSet()
{
   myDataSet = new DataSet("myDataSet");
   /* Populates the DataSet with tables, relations, and 
      constraints. */
}

private void BindTextBoxToDataSet()
{
   /* Binds a TextBox control to a DataColumn named
   CompanyName in the DataTable named Suppliers. */
   textBox1.DataBindings.Add
   ("Text", myDataSet, "Suppliers.CompanyName");
}
   

[C++] 
private:
void CreateDataSet()
{
   myDataSet = new DataSet(S"myDataSet");
   /* Populates the DataSet with tables, relations, and 
      constraints. */
}

void BindTextBoxToDataSet()
{
   /* Binds a TextBox control to a DataColumn named
   CompanyName in the DataTable named Suppliers. */
   textBox1->DataBindings->Add
   (S"Text", myDataSet, S"Suppliers.CompanyName");
}
   

[JScript] 
private function CreateDataSet()
{
   myDataSet = new DataSet("myDataSet");
      
   // Creates a DataTable
   var myDataTable : DataTable = new DataTable("Suppliers");

   // Creates two columns, 
   var id : DataColumn = new DataColumn("ID", int);
   var name : DataColumn = new DataColumn("CompanyName", System.String);
   myDataTable.Columns.Add(id);
   myDataTable.Columns.Add(name);

   // Adds the table to the DataSet.
   myDataSet.Tables.Add(myDataTable);

   // Creates three suppliers in the Suppliers Table.
   var dr : DataRow;

   for(var i : int = 1; i < 4; i++)
   {
     dr = myDataTable.NewRow();
     dr[0] = i;
     dr[1] = "Company " + i.ToString();

     myDataTable.Rows.Add(dr);
   }   
}

private function BindTextBoxToDataSet()
{
   /* Binds a TextBox control to a DataColumn named
   CompanyName in the DataTable named Suppliers. */
   textBox1.DataBindings.Add
   (new Binding("Text", myDataSet, "Suppliers.CompanyName"));
}

必要条件

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

参照

Binding クラス | Binding メンバ | System.Windows.Forms 名前空間 | BindingsCollection | CurrencyManager