ControlBindingsCollection::Add Method (Binding^)
.NET Framework (current version)
Adds the specified Binding to the collection.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Exception | Condition |
|---|---|
| ArgumentNullException | The binding is null. |
| ArgumentException | The control property is already data-bound. |
| ArgumentException | The Binding does not specify a valid column of the DataSource. |
The DataSourceUpdateMode property of the Binding created by this overload of the Add method is set to the value of the DefaultDataSourceUpdateMode property.
The CollectionChanged event occurs when the change is complete.
The following code example creates a Binding instance, and uses the Add method to add the instance to the ControlBindingsCollection of a TextBox control.
protected: void BindControls() { /* Create a new Binding using the DataSet and a navigation path(TableName.RelationName.ColumnName). Add event delegates for the Parse and Format events to the Binding object, and add the object to the third TextBox control's BindingsCollection. The delegates must be added before adding the Binding to the collection; otherwise, no formatting occurs until the Current object of the BindingManagerBase for the data source changes. */ Binding^ b = gcnew Binding( "Text",ds,"customers.custToOrders.OrderAmount" ); b->Parse += gcnew ConvertEventHandler( this, &Form1::CurrencyStringToDecimal ); b->Format += gcnew ConvertEventHandler( this, &Form1::DecimalToCurrencyString ); textBox1->DataBindings->Add( b ); }
.NET Framework
Available since 1.1
Available since 1.1
Show: