ControlBindingsCollection.Add メソッド

Binding をコレクションに追加します。

オーバーロードの一覧

指定した Binding をコレクションに追加します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Shadows Sub Add(Binding)

[C#] public new void Add(Binding);

[C++] public: void Add(Binding*);

[JScript] public hide function Add(Binding);

指定したコントロール プロパティ名、データ ソース、およびデータ メンバを使用して Binding を作成し、コレクションに追加します。

.NET Compact Framework でもサポート。

[Visual Basic] Overloads Public Function Add(String, Object, String) As Binding

[C#] public Binding Add(string, object, string);

[C++] public: Binding* Add(String*, Object*, String*);

[JScript] public function Add(String, Object, String) : Binding;

使用例

[Visual Basic, C#, C++] Add メソッドを使用して、3 つの Binding オブジェクトを TextBox コントロールの ControlBindingsCollection に追加する例を次に示します。 ControlBindingsCollection には、 Control クラスの DataBindings プロパティを使用してアクセスします。

[Visual Basic, C#, C++] メモ   ここでは、Add のオーバーロード形式のうちの 1 つだけについて、使用例を示します。その他の例については、各オーバーロード形式のトピックを参照してください。

 
Private Sub BindTextBoxProperties()
    ' Clear the collection before adding new Binding objects.
    textBox1.DataBindings.Clear()
    
    ' Create a DataTable containing Color objects.
    Dim t As DataTable = MakeTable()
    
    ' Bind the Text, BackColor, and ForeColor properties
    ' to columns in the DataTable. 
    textBox1.DataBindings.Add("Text", t, "Text")
    textBox1.DataBindings.Add("BackColor", t, "BackColor")
    textBox1.DataBindings.Add("ForeColor", t, "ForeColor")
End Sub    

Private Function MakeTable() As DataTable
    ' Create a DataTable with three columns.
    ' Two of the columns contain Color objects. 
    
    Dim t As New DataTable("Control")
    t.Columns.Add("BackColor", GetType(Color))
    t.Columns.Add("ForeColor", GetType(Color))
    t.Columns.Add("Text")
    
    ' Add three rows to the table.
    Dim r As DataRow
    
    r = t.NewRow()
    r("BackColor") = Color.Blue
    r("ForeColor") = Color.Yellow
    r("Text") = "Yellow on Blue"
    t.Rows.Add(r)
    
    r = t.NewRow()
    r("BackColor") = Color.White
    r("ForeColor") = Color.Green
    r("Text") = "Green on white"
    t.Rows.Add(r)
    
    r = t.NewRow()
    r("BackColor") = Color.Orange
    r("ForeColor") = Color.Black
    r("Text") = "Black on Orange"
    t.Rows.Add(r)
    
    Return t
End Function

[C#] 
private void BindTextBoxProperties()
{
   // Clear the collection before adding new Binding objects.
   textBox1.DataBindings.Clear();

   // Create a DataTable containing Color objects.
   DataTable t = MakeTable();

   /* Bind the Text, BackColor, and ForeColor properties
   to columns in the DataTable. */
   textBox1.DataBindings.Add("Text", t, "Text");
   textBox1.DataBindings.Add("BackColor", t, "BackColor");
   textBox1.DataBindings.Add("ForeColor", t, "ForeColor");
}

private DataTable MakeTable()
{
   /* Create a DataTable with three columns.
   Two of the columns contain Color objects. */

   DataTable t = new DataTable("Control");
   t.Columns.Add("BackColor", typeof(Color));
   t.Columns.Add("ForeColor", typeof(Color));
   t.Columns.Add("Text");

   // Add three rows to the table.
   DataRow r;

   r = t.NewRow();
   r["BackColor"] = Color.Blue;
   r["ForeColor"] = Color.Yellow;
   r["Text"] = "Yellow on Blue";
   t.Rows.Add(r);

   r = t.NewRow();
   r["BackColor"] = Color.White;
   r["ForeColor"] = Color.Green;
   r["Text"] = "Green on white";
   t.Rows.Add(r);

   r = t.NewRow();
   r["BackColor"] = Color.Orange;
   r["ForeColor"] = Color.Black;
   r["Text"] = "Black on Orange";
   t.Rows.Add(r);

   return t;
}

[C++] 
private:
void BindTextBoxProperties()
{
   // Clear the collection before adding new Binding objects.
   textBox1->DataBindings->Clear();

   // Create a DataTable containing Color objects.
   DataTable* t = MakeTable();

   /* Bind the Text, BackColor, and ForeColor properties
   to columns in the DataTable. */
   textBox1->DataBindings->Add(S"Text", t, S"Text");
   textBox1->DataBindings->Add(S"BackColor", t, S"BackColor");
   textBox1->DataBindings->Add(S"ForeColor", t, S"ForeColor");
}

private:
DataTable* MakeTable()
{
   /* Create a DataTable with three columns.
   Two of the columns contain Color objects. */

   DataTable* t = new DataTable(S"Control");
   t->Columns->Add(S"BackColor", __typeof(Color));
   t->Columns->Add(S"ForeColor", __typeof(Color));
   t->Columns->Add(S"Text");

   // Add three rows to the table.
   DataRow* r;

   r = t->NewRow();
   r->Item[S"BackColor"] = __box(Color::Blue);
   r->Item[S"ForeColor"] = __box(Color::Yellow);
   r->Item[S"Text"] = S"Yellow on Blue";
   t->Rows->Add(r);

   r = t->NewRow();
   r->Item[S"BackColor"] = __box(Color::White);
   r->Item[S"ForeColor"] = __box(Color::Green);
   r->Item[S"Text"] = S"Green on white";
   t->Rows->Add(r);

   r = t->NewRow();
   r->Item[S"BackColor"] = __box(Color::Orange);
   r->Item[S"ForeColor"] = __box(Color::Black);
   r->Item[S"Text"] = S"Black on Orange";
   t->Rows->Add(r);

   return t;
}

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

参照

ControlBindingsCollection クラス | ControlBindingsCollection メンバ | System.Windows.Forms 名前空間