Binding

Wisej.Web.Binding

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.1.0.0)

Represents the simple binding between the property value of an object and the property value of a control.

C#

public class Binding : Binding

VB.NET

Public Class Binding
    Inherits Binding

Constructors

Binding(propertyName, dataSource, dataMember)

Initializes a new instance of the Binding class that simple-binds the indicated control property to the specified data member of the data source.

Name	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.

Throws:

• Exception propertyName is neither a valid property of a control nor an empty string ("").

• ArgumentException The property given by propertyName does not exist on the control.

Binding(propertyName, dataSource, dataMember, formattingEnabled)

Initializes a new instance of the Binding class that binds the indicated control property to the specified data member of the data source, and optionally enables formatting to be applied.

Name	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.
formattingEnabled	Boolean	true to format the displayed data; otherwise, false.

Throws:

• ArgumentException The property given by propertyName does not exist on the control; or the property given is a read-only property.

• Exception Formatting is disabled and propertyName is neither a valid property of a control nor an empty string ("").

Binding(propertyName, dataSource, dataMember, formattingEnabled, dataSourceUpdateMode)

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 and propagates values to the data source based on the specified update setting.

Name	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.
dataSourceUpdateMode	DataSourceUpdateMode	One of the DataSourceUpdateMode values.

Throws:

• 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.

Binding(propertyName, dataSource, dataMember, formattingEnabled, dataSourceUpdateMode, nullValue)

Initializes a new instance of the Binding class that binds the indicated control property to the specified data member of the specified data source. Optionally enables formatting, 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.

Name	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.
dataSourceUpdateMode	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.

Throws:

• 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.

Binding(propertyName, dataSource, dataMember, formattingEnabled, dataSourceUpdateMode, nullValue, formatString)

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.

Name	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.
dataSourceUpdateMode	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.

Throws:

• 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.

Binding(propertyName, dataSource, dataMember, formattingEnabled, dataSourceUpdateMode, nullValue, formatString, formatInfo)

Initializes a new instance of the Binding class with 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; enables formatting with the specified format string; sets the property to the specified value when a DBNull is returned from the data source; and sets the specified format provider.

Name	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.
dataSourceUpdateMode	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.

Throws:

• 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.

Properties

BindableComponent

IBindableComponent: Returns the control the Binding is associated with. (Default: null)

BindingMemberInfo

BindingMemberInfo: Return the binding information based on the dataMember parameter in the Binding constructor.

Control

Control: Returns the control that the binding belongs to. (Default: null)

ControlUpdateMode

ControlUpdateMode: Returns or sets when changes to the data source are propagated to the bound control property. (Default: OnPropertyChanged)

DataSourceUpdateMode

DataSourceUpdateMode: Returns or sets a value that indicates when changes to the bound control property are propagated to the data source. (Default: OnValidation)

Events

BindingComplete

BindingCompleteEventHandler Fired when the FormattingEnabled property true and a binding operation is completed.

Format

ConvertEventHandler Fired when the property of a control is bound to a data value.

Parse

ConvertEventHandler Fired when the value of a data-bound control changes.