Binding Constructor (String^, Object^, String^, Boolean, DataSourceUpdateMode, Object^, String^)
Initializes a new instance of the Binding class that binds the specified control property to the specified data member of the specified data source. Optionally enables formatting with the specified format string; propagates values to the data source based on the specified update setting; and sets the property to the specified value when a DBNull is returned from the data source.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public: Binding( String^ propertyName, Object^ dataSource, String^ dataMember, bool formattingEnabled, DataSourceUpdateMode dataSourceUpdateMode, Object^ nullValue, String^ formatString )
Parameters
- propertyName
-
Type:
System::String^
The name of the control property to bind.
- dataSource
-
Type:
System::Object^
An Object representing the data source.
- dataMember
-
Type:
System::String^
The property or list to bind to.
- formattingEnabled
-
Type:
System::Boolean
true to format the displayed data; otherwise, false.
- dataSourceUpdateMode
-
Type:
System.Windows.Forms::DataSourceUpdateMode
One of the DataSourceUpdateMode values.
- nullValue
-
Type:
System::Object^
The Object to be applied to the bound control property if the data source value is DBNull.
- formatString
-
Type:
System::String^
One or more format specifier characters that indicate how a value is to be displayed.
| Exception | Condition |
|---|---|
| ArgumentException | The property given by propertyName does not exist on the control. -or- The data source or data member or control property specified are associated with another binding in the collection. |
You can specify an instance of any of the following classes for the data source:
Any class that implements the IList interface
Any class
See the Binding class for more information about creating the dataMember string.
When you create a binding to a control's property, the new Binding inspects the events exposed by the bound control and attaches to two particular events:
An event named PropertyNameChanged (for example, Control::BackColorChanged)
Available since 2.0