ControlBindingsCollection

Wisej.Web.ControlBindingsCollection

Namespace: Wisej.Web

Assembly: Wisej.Framework (2.2.0.0)

Represents the collection of data bindings for a control.

C#

public class ControlBindingsCollection : ControlBindingsCollection

VB.NET

Public Class ControlBindingsCollection
    Inherits ControlBindingsCollection

Constructors

ControlBindingsCollection(control)

Initializes a new instance of the ControlBindingsCollection class with the specified bindable control.

Name	Type	Description
control	IBindableComponent	The IBindableComponent the binding collection belongs to.

Properties

Control

Control: Returns the control that the collection belongs to.

DefaultDataSourceUpdateMode

DataSourceUpdateMode: Returns or sets the default DataSourceUpdateMode for a Binding in the collection.

Item(name)

Binding: Returns the Binding specified by the control's property name.

Item(index)

Binding: Returns the Binding at the specified index.

Throws:

• IndexOutOfRangeException The collection doesn't contain an item at the specified index.

Methods

Add(binding)

Adds the specified Binding to the collection.

Parameter	Type	Description
binding	Binding	The Binding to add.

Throws:

• ArgumentNullException The binding is null.

• ArgumentException The control property is already data-bound.

• ArgumentException The Binding does not specify a valid column.

Add(propertyName, dataSource, dataMember)

Creates a Binding using the specified control property name, data source, and data member, and adds it to the collection.

Parameter	Type	Description
propertyName	String	The name of the control property to bind.
dataSource	Object	An Object that represents the data source.
dataMember	String	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 .

Add(propertyName, dataSource, dataMember, formattingEnabled)

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	String	The name of the control property to bind.
dataSource	Object	An Object representing the data source.
dataMember	String	The property or list to bind to.
formattingEnabled	Boolean	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 ("").

Add(propertyName, dataSource, dataMember, formattingEnabled, formatString)

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	String	The name of the control property to bind.
dataSource	Object	An Object representing the data source.
dataMember	String	The property or list to bind to.
formattingEnabled	Boolean	true to format the displayed data; otherwise, false
formatString	String	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 ("").

Add(propertyName, dataSource, dataMember, formattingEnabled, nullValue, formatString)

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	String	The name of the control property to bind.
dataSource	Object	An Object representing the data source.
dataMember	String	The property or list to bind to.
formattingEnabled	Boolean	true to format the displayed data; otherwise, false
nullValue	Object	The Object to be applied to the bound control property if the data source value is DBNull.
formatString	String	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 ("").

Add(propertyName, dataSource, dataMember, formattingEnabled, updateMode)

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	String	The name of the control property to bind.
dataSource	Object	An Object representing the data source.
dataMember	String	The property or list to bind to.
formattingEnabled	Boolean	true to format the displayed data; otherwise, false.
updateMode	DataSourceUpdateMode	One of the DataSourceUpdateMode values.

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.

Add(propertyName, dataSource, dataMember, formattingEnabled, updateMode, nullValue)

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	String	The name of the control property to bind.
dataSource	Object	An Object representing the data source.
dataMember	String	The property or list to bind to.
formattingEnabled	Boolean	true to format the displayed data; otherwise, false.
updateMode	DataSourceUpdateMode	One of the DataSourceUpdateMode values.
nullValue	Object	The Object to be applied to the bound control property if the data source value is DBNull.

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.

Add(propertyName, dataSource, dataMember, formattingEnabled, updateMode, nullValue, formatString)

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	String	The name of the control property to bind.
dataSource	Object	An Object representing the data source.
dataMember	String	The property or list to bind to.
formattingEnabled	Boolean	true to format the displayed data; otherwise, false.
updateMode	DataSourceUpdateMode	One of the DataSourceUpdateMode values.
nullValue	Object	The Object to be applied to the bound control property if the data source value is DBNull.
formatString	String	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.

Add(propertyName, dataSource, dataMember, formattingEnabled, updateMode, nullValue, formatString, formatInfo)

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	String	The name of the control property to bind.
dataSource	Object	An Object representing the data source.
dataMember	String	The property or list to bind to.
formattingEnabled	Boolean	true to format the displayed data; otherwise, false.
updateMode	DataSourceUpdateMode	One of the DataSourceUpdateMode values.
nullValue	Object	The Object to be applied to the bound control property if the data source value is DBNull.
formatString	String	One or more format specifier characters that indicate how a value is to be displayed
formatInfo	IFormatProvider	An implementation of IFormatProvider to override default formatting behavior.

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.

Clear()

Removes all bindings in the collection.

Remove(binding)

Removes the specified Binding from the collection.

Parameter	Type	Description
binding	Binding	The Binding to remove.

Throws:

• NullReferenceException The binding is null.

RemoveAt(index)

Removes the Binding at the specified index.

Parameter	Type	Description
index	Int32	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.

Events

CollectionChanged

CollectionChangeEventHandler Fired when the collection has changed.

CollectionChanging

CollectionChangeEventHandler Fired when the collection is about to change.