ControlBindingsCollection
Wisej.Web.ControlBindingsCollection
Last updated
Wisej.Web.ControlBindingsCollection
Last updated
Namespace: Wisej.Web
Assembly: Wisej.Framework (3.5.0.0)
Represents the collection of data bindings for a IBindableComponent.
Initializes a new instance of the ControlBindingsCollection class with the specified bindable control.
Name | Type | Description |
---|---|---|
component |
IBindableComponent: Returns the IBindableComponent associated the binding collection.
Control: Returns the Control that the collection belongs to.
DataSourceUpdateMode: Returns or sets the default DataSourceUpdateMode for a Binding in the collection.
Binding: Returns the Binding specified by the control's property name.
Binding: Returns the Binding at the specified index.
Throws:
IndexOutOfRangeException The collection doesn't contain an item at the specified index.
Adds the specified Binding to the collection.
Parameter | Type | Description |
---|---|---|
binding |
Throws:
ArgumentNullException The binding is null.
ArgumentException The control property is already data-bound.
ArgumentException The Binding does not specify a valid column.
Creates a Binding using the specified control property name, data source, and data member, and adds it to the collection.
Parameter | Type | Description |
---|---|---|
propertyName | The name of the control property to bind. | |
dataSource | ||
dataMember | The property or list to bind to. |
Returns: Binding. The newly created Binding.
Throws:
Exception The propertyName is already data-bound.
Exception The dataMember doesn't specify a valid member of the dataSource .
Creates a binding with the specified control property name, data source, data member, and information about whether formatting is enabled, and adds the binding to the collection.
Parameter | Type | Description |
---|---|---|
propertyName | The name of the control property to bind. | |
dataSource | ||
dataMember | The property or list to bind to. | |
formattingEnabled | true to format the displayed data; otherwise, false |
Returns: Binding. The newly created Binding.
Throws:
ArgumentException The property given by propertyName does not exist on the control.-or-The property given is a read-only property.
Exception If formatting is disabled and the propertyName is neither a valid property of a control nor an empty string ("").
Creates a binding with the specified control property name, data source, data member, and information about whether formatting is enabled, and adds the binding to the collection.
Parameter | Type | Description |
---|---|---|
propertyName | The name of the control property to bind. | |
dataSource | ||
dataMember | The property or list to bind to. | |
formattingEnabled | true to format the displayed data; otherwise, false | |
formatString | One or more format specifier characters that indicate how a value is to be displayed. |
Returns: Binding. The newly created Binding.
Throws:
ArgumentException The property given by propertyName does not exist on the control.-or-The property given is a read-only property.
Exception If formatting is disabled and the propertyName is neither a valid property of a control nor an empty string ("").
Creates a binding with the specified control property name, data source, data member, and information about whether formatting is enabled, and adds the binding to the collection.
Parameter | Type | Description |
---|---|---|
propertyName | The name of the control property to bind. | |
dataSource | ||
dataMember | The property or list to bind to. | |
formattingEnabled | true to format the displayed data; otherwise, false | |
nullValue | ||
formatString | One or more format specifier characters that indicate how a value is to be displayed. |
Returns: Binding. The newly created Binding.
Throws:
ArgumentException The property given by propertyName does not exist on the control.-or-The property given is a read-only property.
Exception If formatting is disabled and the propertyName is neither a valid property of a control nor an empty string ("").
Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, and adding the binding to the collection.
Parameter | Type | Description |
---|---|---|
propertyName | The name of the control property to bind. | |
dataSource | ||
dataMember | The property or list to bind to. | |
formattingEnabled | true to format the displayed data; otherwise, false. | |
updateMode |
Returns: Binding. The newly created Binding.
Throws:
ArgumentException The property given by propertyName does not exist on the control or is read-only.-or-The specified data member does not exist on the data source.-or-The data source, data member, or control property specified are associated with another binding in the collection.
Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the collection.
Parameter | Type | Description |
---|---|---|
propertyName | The name of the control property to bind. | |
dataSource | ||
dataMember | The property or list to bind to. | |
formattingEnabled | true to format the displayed data; otherwise, false. | |
updateMode | ||
nullValue |
Returns: Binding. The newly created Binding
Throws:
ArgumentException The property given by propertyName does not exist on the control or is read-only.-or-The specified data member does not exist on the data source.-or-The data source, data member, or control property specified are associated with another binding in the collection.
Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the collection.
Parameter | Type | Description |
---|---|---|
propertyName | The name of the control property to bind. | |
dataSource | ||
dataMember | The property or list to bind to. | |
formattingEnabled | true to format the displayed data; otherwise, false. | |
updateMode | ||
nullValue | ||
formatString | One or more format specifier characters that indicate how a value is to be displayed. |
Returns: Binding. The newly created Binding
Throws:
ArgumentException The property given by propertyName does not exist on the control or is read-only.-or-The specified data member does not exist on the data source.-or-The data source, data member, or control property specified are associated with another binding in the collection.
Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, setting the specified format provider, and adding the binding to the collection.
Parameter | Type | Description |
---|---|---|
propertyName | The name of the control property to bind. | |
dataSource | ||
dataMember | The property or list to bind to. | |
formattingEnabled | true to format the displayed data; otherwise, false. | |
updateMode | ||
nullValue | ||
formatString | One or more format specifier characters that indicate how a value is to be displayed | |
formatInfo |
Returns: Binding. The newly created Binding.
Throws:
ArgumentException The property given by propertyName does not exist on the control or is read-only.-or-The specified data member does not exist on the data source.-or-The data source, data member, or control property specified are associated with another binding in the collection.
Removes all bindings in the collection.
Removes the specified Binding from the collection.
Parameter | Type | Description |
---|---|---|
binding |
Throws:
NullReferenceException The binding is null.
Removes the Binding at the specified index.
Parameter | Type | Description |
---|---|---|
index | The zero-based index of the item to remove. |
Throws:
ArgumentOutOfRangeException The index value is less than 0, or it is greater than the number of bindings in the collection.
CollectionChangeEventHandler Fired when the collection has changed.
CollectionChangeEventHandler Fired when the collection is about to change.
The the binding collection belongs to.
The to add.
An that represents the data source.
An representing the data source.
An representing the data source.
An representing the data source.
The to be applied to the bound control property if the data source value is .
An representing the data source.
One of the values.
An representing the data source.
One of the values.
The to be applied to the bound control property if the data source value is .
An representing the data source.
One of the values.
The to be applied to the bound control property if the data source value is .
An representing the data source.
One of the values.
The to be applied to the bound control property if the data source value is .
An implementation of to override default formatting behavior.
The to remove.