Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Wisej.Web.BindingManagerBase
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Manages all objects that are bound to the same data source and data member.
: Returns the collection of bindings being managed.
: Returns the number of items in the list.
: Returns the current item in the list.
: Returns whether binding is suspended.
Adds a new item to the underlying list.
Throws:
Cancels the current edit operation.
Ends the current edit operation.
Returns the property descriptor collection for the underlying list.
Removes the item at the specified index.
Throws:
Resumes data binding.
Suspends data binding to prevents changes from updating the bound data source.
Wisej.Web.Binding
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Represents the simple binding between the property value of an object and the property value of a control.
Initializes a new instance of the class that simple-binds the indicated control property to the specified data member of the data source.
Name | Type | Description |
---|
Throws:
propertyName is neither a valid property of a control nor an empty string ("").
The property given by propertyName does not exist on the control.
Initializes a new instance of the 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 |
---|
Throws:
Throws:
Throws:
Throws:
Throws:
: Returns or sets the position of the data binding source within the list.
The underlying data source does not implement , or the data source has thrown an exception because the user has attempted to add a row to a read-only or fixed-size .
Returns: . A for the list.
Parameter | Type | Description |
---|
There is no row at the specified index .
Fired at the completion of a data-binding operation.
Fired when the currently bound item changes.
Fired when the state of the currently bound item changes.
Fired when an is silently handled by the .
Fired after the value of the property has changed.
Name | Description |
---|
The property given by propertyName does not exist on the control; or the property given is a read-only property.
Formatting is disabled and propertyName is neither a valid property of a control nor an empty string ("").
Initializes a new instance of the 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 |
---|
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.
Initializes a new instance of the 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 is returned from the data source.
Name | Type | Description |
---|
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.
Initializes a new instance of the 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 is returned from the data source.
Name | Type | Description |
---|
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.
Initializes a new instance of the 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 is returned from the data source; and sets the specified format provider.
Name | Type | Description |
---|
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.
: Returns the control the is associated with.
: Return the binding information based on the dataMember parameter in the constructor.
: Returns the control that the binding belongs to.
: Returns or sets when changes to the data source are propagated to the bound control property.
: Returns or sets a value that indicates when changes to the bound control property are propagated to the data source.
Fired when the property true and a binding operation is completed.
Fired when the property of a control is bound to a data value.
Fired when the value of a data-bound control changes.
DataError
The binding operation failed with a data error.
Exception
The binding operation failed with an exception.
Success
The binding operation completed successfully.
Returns the completion state of the binding operation.
index | The index of the item to remove from the list. |
Keeps data-bound controls synchronized with each other: showing data from the same record. |
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. |
dataSourceUpdateMode |
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. |
dataSourceUpdateMode |
nullValue |
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. |
dataSourceUpdateMode |
nullValue |
formatString | One or more format specifier characters that indicate how a value is to be displayed. |
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. |
dataSourceUpdateMode |
nullValue |
formatString | One or more format specifier characters that indicate how a value is to be displayed. |
formatInfo |
sender | The source of the event. |
e | A that contains the event data. |
Fired when the property true and a binding operation is completed. |
Fired at the completion of a data-binding operation. |
Fired when all the clients have been bound to this . |
propertyName | The name of the control property to bind. |
dataSource |
dataMember | The property or list to bind to. |
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. |
Wisej.Web.BindingContext
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Manages the collection of BindingManagerBase objects for any object that inherits from the Control class.
Creates a new instance of BindingContext.
Boolean: Returns whether the collection is read-only.
BindingManagerBase: Returns the BindingManagerBase that is associated with the data source.
BindingManagerBase: Returns a BindingManagerBase that is associated with the data source and data member.
Throws:
Exception The specified dataMember does not exist in the specified data source.
Returns whether the BindingContext contains the BindingManagerBase associated with the data source.
Returns: Boolean. true if the BindingContext contains the BindingManagerBase; otherwise, false.
Returns whether the BindingContext contains the BindingManagerBase associated with the data source and data member.
Returns: Boolean. true if the BindingContext contains the BindingManagerBase; otherwise, false.
Associates a Binding with a new BindingContext.
Wisej.Web.BindingMemberInfo
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Contains information that enables a Binding to resolve a data binding to either the property of an object or the property of the current object in a list of objects.
Initializes a new instance of the BindingMemberInfo class.
Name | Type | Description |
---|---|---|
String: Returns the property name of the data-bound object.
String: Returns the information that is used to specify the property name of the data-bound object.
String: Returns the property name, or the period-delimited hierarchy of property names, that comes before the property name of the data-bound object.
Wisej.Web.BindingManagerDataErrorEventArgs
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Provides data for the DataError event.
Initializes a new instance of the BindingManagerDataErrorEventArgs class.
Name | Type | Description |
---|---|---|
Exception: Returns the Exception caught in the binding process.
Name | Description |
---|---|
Wisej.Web.BindingNavigator
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Represents the navigation and manipulation user interface (UI) for controls that are bound to a data source.
Initializes a new instance of the BindingNavigator class with the specified BindingSource as the data source.
Name | Type | Description |
---|---|---|
Initializes a new instance of the BindingNavigator class, indicating whether to display the standard navigation user interface (UI).
Button: Returns or sets the "Add New" button.
BindingSource: Returns or sets the BindingSource component that is the source of data.
Label: Returns or sets the control that displays the total number of items in the associated BindingSource.
String: Gets or sets a string used to format the information displayed in the CountItem control.
Button: Returns or sets the "Delete" button.
Button: Returns or sets the "Move First" button.
Button: Returns or sets the "Move Last" button.
Button: Returns or sets the "Move Next" button.
Button: Returns or sets the "Move Previous" button.
Orientation: Returns or sets a value indicating the horizontal or vertical orientation of the BindingNavigator control.
When the control is docked, this property is managed automatically.
TextBox: Returns or sets the TextBox control that displays the current position within the associated BindingSource.
String: Returns or sets the text to display on the tab.
Adds the standard set of navigation items to the BindingNavigator control.
Disables updates to the controls of during the component's initialization.
Enables updates to the controls after the component's initialization has completed.
Causes validation to occur and returns whether validation was successful.
Returns: Boolean. true if validation was successful and focus can shift to the BindingNavigator; otherwise, false.
EventHandler Fired when the state of the navigational user interface (UI) needs to be refreshed to reflect the current state of the underlying data source.
EventHandler Fired when the value of the Text property changes.
Wisej.Web.BindingManagerDataErrorEventHandler
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Represents the method that will handle the DataError event.
Name | Type | Description |
---|---|---|
Name | Description |
---|---|
Wisej.Web.BindingCompleteEventArgs
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Provides data for the BindingComplete event.
Initializes a new instance of the BindingCompleteEventArgs class with the specified binding, error state and text, binding context, exception, and whether the binding should be canceled.
Name | Type | Description |
---|---|---|
Initializes a new instance of the BindingCompleteEventArgs class with the specified binding, error state and text, binding context, and exception.
Name | Type | Description |
---|---|---|
Initializes a new instance of the BindingCompleteEventArgs class with the specified binding, error state and text, and binding context.
Initializes a new instance of the BindingCompleteEventArgs class with the specified binding, error state, and binding context.
Binding: Returns the binding associated with this occurrence of a BindingComplete event.
BindingCompleteContext: Returns the direction of the binding operation.
BindingCompleteState: Returns the completion state of the binding operation.
String: Returns the text description of the error that occurred during the binding operation.
Exception: Returns the exception that occurred during the binding operation.
Wisej.Web.ConvertEventArgs
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Base for the specialized convert event handlers.
Initializes a new instance of the ConvertEventArgs class.
Name | Type | Description |
---|---|---|
Type: Returns the data type of the desired value.
Object: Returns or sets the value of the ConvertEventArgs.
Wisej.Web.BindingSource
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Encapsulates the data source for a data-bound component.
Initializes a new instance of the BindingSource class to the default property values.
Initializes a new instance of the BindingSource class and adds the BindingSource to the specified container.
Name | Type | Description |
---|---|---|
Initializes a new instance of the BindingSource class with the specified data source and data member.
Name | Type | Description |
---|---|---|
Boolean: Returns whether items in the underlying list can be edited.
Boolean: Returns or sets whether the AddNew method can be used to add items to the list.
Throws:
InvalidOperationException This property is set to true when the underlying list represented by the List property has a fixed size or is read-only.
MissingMethodException The property is set to true and the AddingNew event is not handled when the underlying list type does not have a default constructor.
Boolean: Returns whether the items can be removed from the underlying list.
Int32: Returns the total number of items in the underlying list, filtered using the current Filter value.
CurrencyManager: Returns the currency manager associated with this BindingSource.
Object: Returns the current item in the list.
Use the Current property to access the current item, but use the List property to get the entire list. To determine the type of the current object, use the GetType, or ToString methods. To change the current item, set the Position property to a new integral value, or use one of the navigation methods such as MoveNext.
String: Returns or sets the list in the data source to which the connector currently binds to.
If the DataSource contains multiple lists (or tables) of data, you should set the DataMember property to the name of one of the sources. Setting this property raises the DataMemberChanged event
Object: Returns or sets the data source that the connector binds to.
The DataSource property can be set to a number of data sources, including types, objects, and lists of types. The resulting data source will be exposed as a list. The following table shows some of the common data sources and the resulting list evaluation.
| DataSource | List Result | | :--- | | null | An empty IBindingList of objects. Adding an item sets the list to the type of the added item. | | null with DataMember set | Not supported, raises ArgumentException. | | Non-list type or object of type "T" | Empty IBindingList of type "T". | | Array instance | IBindingList containing the array elements. | | IEnumerable instance | An IBindingList containing the IEnumerable items. | | List instance containing type "T" | IBindingList instance containing type "T". |
In addition, DataSource can be set to other list types such as IListSource and ITypedList and the BindingSource will handle them appropriately. In this case, the type contained in the list should have a parameterless constructor. When setting a data source, if the supplied reference contains more than one list or table, you must set the DataMember property to a string that specifies the list to bind to. Setting this property raises the DataSourceChanged event.
String: Returns or sets the expression used to filter the items in the underlying List.
Typically used in complex data-binding scenarios, the Filter property allows you to view a subset of the DataSource. Only underlying lists that implement the IBindingListView interface support filtering. When Filter is not null, the BindingSource passes this property to the underlying list. If you set this property during object initialization, the call will be deferred until after initialization is complete. To form a filter value, specify the name of a column followed by an operator and a value to filter on. The accepted filter syntax depends on the underlying data source. If the underlying data source is a DataSet, DataTable, or DataView, you can specify Boolean expressions using the syntax documented for the DataColumn.Expression property. The value of the Filter property affects the value of the Count property. Additionally, the Filter value will persist when the data source changes. To stop filtering the DataSource, call the RemoveFilter method.
Boolean: Returns whether data binding is suspended.
Boolean: Returns whether the underlying List has a fixed size.
Boolean: Return whether the underlying List is read-only.
Boolean: Returns whether the items in the underlying List are sorted.
Boolean: Returns whether access to the collection is synchronized (thread safe).
Object: Returns or sets the list element at the specified index in the underlying List.
Throws:
ArgumentOutOfRangeException index is less than zero or is equal to or greater than Count.
IList: Returns the underlying data list.
The BindingSource class uniformly handles different data sources. Ideally the List property should be set to a general IList. However, sometimes it may be necessary to cast this property to a more specific type. The following table shows the underlying list type, which depends on the type or value of the data source.
| DataSource Type | Underlying List Description | | :--- | | DataSource and DataMember are null | An empty ArrayList. | | DataSource is null, but DataMember is not null | None; an attempt to get the List will throw an ArgumentException. | | An Array instance | An Array. | | An IListSource instance | The return value from a call to the GetList() method of this IListSource instance. | | An IBindingList instance | An IBindingList. | | An IList instance | An IList. | | A non-IList instance of type "T" | A BindingList with one element. | | An ICustomTypeDescriptor instance | An ArrayList with one element. | | An IEnumerable | An ArrayList with the elements copied over. | | The Array type with DataMember of item type "T" | A BindingList. | | A Type that represents an IListSource or ITypedList | An instance created by a call to the CreateInstance(Type) method of the Activator class. A NotSupportedException may be thrown. | | The IList type with DataMember of item type "T" or a non-IList type | A BindingList | | The ICustomTypeDescriptor type | None; an attempt to get the List will throw an NotSupportedException. |
If the type retrieved is the IList interface, the underlying collection may be more complex, such as an ArrayList or DataView class.
Int32: Returns or sets the index of the current item in the underlying List.
When setting the Position property, out-of-range values are treated in the following manner:
Negative values are treated as 0.
Values greater than or equal to Count are treated as Count minus 1.
Changing the Position property will adjust the Current property.
Boolean: Returns or sets a value indicating whether ListChanged events should be raised.
When the RaiseListChangedEvents property is false, it suspends the raising of the ListChanged events. This event indicates that the bound list has been modified in some way, including adding, deleting, inserting, or modifying items.
Boolean: Enables the automatic refresh of the source property after a data-bound value has been updated in the data source.
This option fixes a long standing "feature" of the default BindingSource where the property that is the source of a value change is not refreshed automatically after it updates the bound data source. In a scenario where the data source "transforms" the value received from a data-bound control, the source property is not updated while all other bound properties are.
String: Returns or sets the column names used for sorting, and the sort order for viewing the rows in the data source.
The Sort property is a case-sensitive string that specifies the column names used to sort the rows, along with the SortDirection. Columns are sorted ascending by default. Multiple columns can be separated by commas, such as "State, ZipCode DESC". To support sorting, the underlying List must implement the IBindingList or IBindingListView interfaces. This capability can be queried through the SupportsSorting property. Multicolumn sorting is available when the SupportsAdvancedSorting property is true. Setting the Sort property will change the internal list depending on its type:
If the list is of type IBindingList, the SortProperty and SortDirection properties are set in the internal list.
If the list is of type IBindingListView, the SortDescriptions property is set.
The internal list's sort properties are only changed when the sort string is not null. The get accessor for this property will not retrieve the sort value of the internal list; instead, it will return the set accessor value. The value of the Sort property will persist when the data source changes.
ListSortDescriptionCollection: Returns the collection of sort descriptions applied to the data source.
If the data source is not an IBindingListView, the SortDescriptions property always returns null.
ListSortDirection: Returns the direction the items in the underlying List are sorted.
If the data source is not an IBindingList, the SortDirection property always returns Ascending.
PropertyDescriptor: Returns the PropertyDescriptor that is being used for sorting the underlying List.
If the data source is not an IBindingList, the SortProperty property always returns null.
Boolean: Returns whether the data source supports multi-column sorting.
If the data source is not an IBindingListView, the SupportsAdvancedSorting property always returns false.
Boolean: Return whether the data source supports change notification.
Boolean: Returns whether the data source supports filtering.
If the data source is not an IBindingList, the SupportsFiltering property always returns false.
Boolean: Returns whether the data source supports searching with the Find method.
If the data source is not an IBindingList, the SupportsSearching property always returns false.
Boolean: Returns whether the data source supports sorting.
If the data source is not an IBindingList, the SupportsSorting property always returns false.
Object: Returns an object used to synchronize access to the underlying List.
Adds an existing item to the underlying List.
Returns: Int32. The index at which the item was added to the underlying List.
Adds a new item to the underlying List.
Returns: Object. The object that was created and added to the underlying List.
Sorts the data source using the specified property descriptor and sort direction.
The IBindingList implements single column sorting using a PropertyDescriptor to indicate a property to sort by and a ListSortDirection indicating whether the property contents should be sorted in ascending or descending order. Throws:
NotSupportedException The data source is not an IBindingList.
Sorts the data source with the specified sort descriptions.
IBindingListView implements multi-column sorting as a set of property descriptor-direction pairs. Throws:
NotSupportedException The data source is not an IBindingListView.
Cancels the current edit operation.
Removes all elements from the list.
Determines whether the item is present in he underlying List.
Returns: Boolean. true if the item is found in the List.
Copies the contents of the List to the specified array , starting at the specified index value.
Applies pending changes to the underlying data source.
When the EndEdit method is called, all pending changes are applied to the underlying data source. This method has no effect unless the objects contained by the data source implement the IEditableObject interface. If the objects do not implement the IEditableObject interface, changes to the data are copied to the underlying data source immediately after each change. This method raises the ListChanged event.
Returns the index of the item in the list with the specified propertyName and value .
Returns: Int32. The zero-based index of the item with the specified propertyName and value .
Throws:
InvalidOperationException The underlying list is not a IBindingList with searching functionality implemented.
ArgumentException propertyName does not match a property in the list.
Searches for the index of the that has the given value in the specified property .
Returns: Int32. The index of the item that has the given value .
Throws:
ArgumentException propertyName does not match a property in the list.
Retrieves an enumerator for the underlying List.
Returns: IEnumerator. An IEnumerator for the List.
Retrieves an array of PropertyDescriptor objects representing the bindable properties of the data source list type.
Returns: PropertyDescriptorCollection. An array of PropertyDescriptor objects that represents the properties on this list type used to bind data.
Returns the name of the list supplying data for the binding operations.
Returns: String. The name of the list supplying the data for binding operations.
Returns the related CurrencyManager for the specified data member.
Returns: CurrencyManager. The related CurrencyManager for the specified data member.
Returns the index of the specified item in the underlying List.
Returns: Int32. The index of the first occurrence of item in the List.
Inserts an item into the List at the specified index .
Throws:
ArgumentOutOfRangeException index is less than zero or greater than Count.
NotSupportedException The list is read-only or has a fixed size.
Moves the current position to the first item in the List.
Moves the current position to the last item in the List.
Moves the current position to the next item in the List.
Moves the current position to the previous item in the List.
Removes the specified item from the List.
Removes the item at the specified index from the List.
Removes the current item from the List.
Removes the filter associated with this BindingSource
Removes the sort information associated with this BindingSource.
Throws:
NotSupportedException The underlying data source does not support sorting.
Causes a control bound to this BindingSource to re-read all the items and refresh their displayed value.
Causes a control bound to this BindingSource to re-read the current item and refresh the displayed value.
Causes a control bound to this BindingSource to read the item at the specified itemIndex and refresh the displayed value.
Resumes data binding.
Suspends data binding to prevent changes from updating the data-bound data source.
AddingNewEventHandler Fired before an item is added to the underlying List.
BindingCompleteEventHandler Fired when all the clients have been bound to this BindingSource.
EventHandler Occurs when the currently bound item changes.
EventHandler Occurs when a property value of the Current property has changed.
BindingManagerDataErrorEventHandler Fired when a currency-related exception is silently handled by the BindingSource.
EventHandler Fired when the DataMember property value has changed.
EventHandler Fired when the DataSource property value has changed.
ListChangedEventHandler Fired when the underlying List changes or an item in the list changes.
EventHandler Fired after the value of the Position property has changed.
Wisej.Web.ControlBindingsCollection
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Represents the collection of data bindings for a control.
Initializes a new instance of the ControlBindingsCollection class with the specified bindable control.
Name | Type | Description |
---|---|---|
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Throws:
NullReferenceException The binding is null.
Removes the Binding at the specified index.
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.
Wisej.Web.BindingsCollection
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Represents a collection of objects for a control.
: Returns the total number of bindings in the collection.
: Returns the at the specified index.
Throws:
The collection doesn't contain an item at the specified index.
Wisej.Web.CurrencyManager
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Keeps data-bound controls synchronized with each other: showing data from the same record.
: Returns the number of items in the list.
: Returns the current item in the list.
: Returns the list for this .
Forces a refresh of the data-bound list.
Resumes data binding.
Suspends data binding to prevents changes from updating the bound data source.
Wisej.Web.ListBindingConverter
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Provides a type converter to convert objects to and from various other representations.
Initializes a new instance of the class.
Returns whether this converter can convert the object to the specified type using the specified context.
Parameter | Type | Description |
---|
Returns: . true if this converter can perform the conversion; otherwise, false.
Converts the given value object to the specified type, using the specified context and culture information.
Wisej.Web.IBindableComponent
Wisej.Web.ICurrencyManagerProvider
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Provides custom binding management for components.
: Returns the associated with this .
Return the for this and the specified data member.
Parameter | Type | Description |
---|
Returns: . The related obtained from this and the specified data member.
Maintains a between an object's property and a data-bound control property.
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.
An that represents the data source.
An that represents the data source.
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Name | Description |
---|---|
Name | Type | Description |
---|---|---|
Name | Description |
---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Description |
---|---|
Name | Description |
---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Name | Description |
---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Fired when the collection has changed.
Fired when the collection is about to change.
: Returns or sets the current position within the list.
: Returns true when the bound data source can accept changes. Calling sets this flag to false and sets it to true (default).
Fired when the current item has been altered.
Fired when the list changes or an item in the list changes.
Fired when the metadata of the has changed.
Parameter | Type | Description |
---|
Returns: . An that represents the converted value.
Creates an instance of the type that this is associated with, using the specified context, given a set of property values for the object.
Parameter | Type | Description |
---|
Returns: . An representing the given , or null if the object cannot be created. This method always returns null.
Returns whether changing a value on this object requires a call to the method to create a new value.
Parameter | Type | Description |
---|
Returns: . true if changing a property on this object requires a call to to create a new value; otherwise, false.
Name | Description |
---|
dataSource
An Object that represents the data source.
dataSource
An Object that represents the data source.
dataMember
The information needed to resolve to a specific BindingManagerBase.
newBindingContext
The new BindingContext to associate with the Binding.
binding
The Binding to associate with the new BindingContext.
Return the binding information based on the dataMember parameter in the Binding constructor.
addStandardItems
true to show the standard navigational UI; otherwise, false.
Bindable components implement this interface.
All wisej components implement this interface.
All wisej controls derived from the Control class must implement this interface.
Allows an object to serialize itself.
sender
The source of the event.
e
A BindingManagerDataErrorEventArgs that contains the event data.
Fired when an Exception is silently handled by the BindingManagerBase.
Fired when a currency-related exception is silently handled by the BindingSource.
binding
The binding associated with this occurrence of a BindingComplete event.
state
One of the BindingCompleteState values.
context
One of the BindingCompleteContext values.
errorText
The error text or exception message for errors that occurred during the binding.
binding
The binding associated with this occurrence of a BindingComplete event.
state
One of the BindingCompleteState values.
context
One of the BindingCompleteContext values.
Represents the delegate that handles the BindingComplete event.
Never
The bound control is never updated when a data source value changes.
OnPropertyChanged
The corresponding property of the bound control is updated when the data source value changes, or the data source position (current record) changes.
Returns or sets when changes to the data source are propagated to the bound control property.
item
Item to add the underlying List.
property
A PropertyDescriptor that describes the property by which to sort the data source.
sort
A ListSortDescription indicating how the list should be sorted.
sorts
A ListSortDescriptionCollection containing the sort descriptions to apply to the data source.
item
Item to locate in the underlying List.
array
The destination array.
index
The index in the destination array at which to start the copy.
propertyName
The name of the property to search.
value
The value of the item with the specified propertyName to find.
property
The PropertyDescriptor to search.
value
The value of the property to match.
listAccessors
An array of PropertyDescriptor objects to find in the List type.
listAccessors
An array of PropertyDescriptor objects to find in the list as bindable.
dataMember
The name of column or list, within the data source to retrieve the currency manager for.
item
item to locate.
index
Index at which to insert the item.
item
Item to insert, it can be null.
item
Item to remove.
index
Index of the item to remove.
metadataChanged
true if the schema has changed; false if only the data has changed.
itemIndex
The index of the item that has changed.
Provides custom binding management for components.
binding
The Binding to add.
propertyName
The name of the control property to bind.
dataSource
An Object that represents the data source.
dataMember
The property or list to bind to.
propertyName
The name of the control property to bind.
dataSource
An Object representing the data source.
dataMember
The property or list to bind to.
formattingEnabled
true to format the displayed data; otherwise, false
propertyName
The name of the control property to bind.
dataSource
An Object representing the data source.
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.
propertyName
The name of the control property to bind.
dataSource
An Object representing the data source.
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.
propertyName
The name of the control property to bind.
dataSource
An Object representing the data source.
dataMember
The property or list to bind to.
formattingEnabled
true to format the displayed data; otherwise, false.
updateMode
One of the DataSourceUpdateMode values.
propertyName
The name of the control property to bind.
dataSource
An Object representing the data source.
dataMember
The property or list to bind to.
formattingEnabled
true to format the displayed data; otherwise, false.
updateMode
One of the DataSourceUpdateMode values.
nullValue
propertyName
The name of the control property to bind.
dataSource
An Object representing the data source.
dataMember
The property or list to bind to.
formattingEnabled
true to format the displayed data; otherwise, false.
updateMode
One of the DataSourceUpdateMode values.
nullValue
formatString
One or more format specifier characters that indicate how a value is to be displayed.
propertyName
The name of the control property to bind.
dataSource
An Object representing the data source.
dataMember
The property or list to bind to.
formattingEnabled
true to format the displayed data; otherwise, false.
updateMode
One of the DataSourceUpdateMode values.
nullValue
formatString
One or more format specifier characters that indicate how a value is to be displayed
formatInfo
An implementation of IFormatProvider to override default formatting behavior.
binding
The Binding to remove.
index
The zero-based index of the item to remove.
context |
culture |
value |
destinationType |
context |
propertyValues |
context |
Encapsulates the data source for a data-bound component. |
dataMember
A navigation path that resolves to either the property of an object or the property of the current object in a list of objects.
exception
The Exception that occurred in the binding process.
Represents the method that will handle the DataError event.
bindingSource
The BindingSource used as a data source.
binding
The binding associated with this occurrence of a BindingComplete event.
state
One of the BindingCompleteState values.
context
One of the BindingCompleteContext values.
errorText
The error text or exception message for errors that occurred during the binding.
exception
The Exception that occurred during the binding.
cancel
true to cancel the binding and keep focus on the current control; false to allow focus to shift to another control.
binding
The binding associated with this occurrence of a BindingComplete event.
state
One of the BindingCompleteState values.
context
One of the BindingCompleteContext values.
errorText
The error text or exception message for errors that occurred during the binding.
exception
The Exception that occurred during the binding.
value
An Object that contains the value of the current property.
desiredType
The Type of the value.
container
The IContainer to add the current BindingSource to.
dataSource
The data source for the BindingSource.
dataMember
The specific column or list name within the data source to bind to.
control
The IBindableComponent the binding collection belongs to.
sender | The source of the event. |
e | A that contains the event data. |
Fired when the property of a control is bound to a data value. |
Fired when the value of a data-bound control changes. |
ControlUpdate | The control property value is being updated from the data source. |
DataSourceUpdate | The data source value is being updated from the control property. |
Returns the direction of the binding operation. |
context |
destinationType |
UI implementation for the FileDialog class. |
UI implementation for the FolderDialog class. |
Represents the navigation and manipulation user interface (UI) for controls that are bound to a data source. |
Represents a button control. |
Implements the basic functionality common to button controls. |
Represents a check box control. |
Represents a combo box control. |
Provides focus-management functionality for controls that can function as a container for other controls. |
Base class for all Wisej controls. |
Represents a control that allows the user to select or type a date and a time. |
Represents a spinner control that displays string values. |
Represents a panel that dynamically arranges its children horizontally or vertically in automatic rows or columns. |
Represents a window or dialog box that makes up an application's user interface. |
Represents a Wisej control that displays a frame around a group of controls with an optional caption. |
Represents a label control. |
Represents an hyper-link control. |
Represents a control to display a list of items. |
Uses a mask to distinguish between proper and improper user input. |
Represents the container for multiple-document interface (MDI) child forms. |
Represents a control that enables the user to select a date using a visual monthly calendar display. |
Represents a spinner control that displays numeric values. |
Represents a web page that fills the browser and acts as the main container for the application. An application can have only one active main page at any given time. |
Represents a collapsible panel with an optional header that contains a group of controls. |
Represents an image control. |
Represents a progress control that displays a value visually as a filled bar. |
Defines a base class for controls that support auto-scrolling behavior. |
Represents an horizontal scroll bar. |
Represents a vertical scroll bar. |
Implements the basic functionality of a scroll bar control. |
Represents a control consisting of a movable bar that divides a container's display area into two resizable panels. |
Represents a panel that dynamically lays out its contents in a grid composed of rows and columns. |
Represents a text box control that allows the user to enter any value. |
Implements the basic functionality required by text controls. |
Enables the user to choose between a range of values by sliding a small bar along another bar. |
Implements the basic functionality required by a spin box (also known as an up-down control). |
Provides an empty control that can be used to create other controls. |
Represents a web browser control that enables the user to navigate web pages inside a form or a page. |
Represents a data grid control. |
Displays data in a customizable list format. |
Represents a desktop container that can host floating windows. |
Represents a control that can host ASP.NET or MVC pages within a Wisej application. |
Represents the HTML5 canvas element. |
Represents a panel that dynamically arranges its child controls. |
Represents a control that displays any HTML file and a corresponding CSS style sheet as embedded HTML. |
Represents a control that displays any HTML file in an IFrame element. |
Represents a line control. |
Base implementation for media controls. |
Represents a shape control. Displays an element a border in any of the four sides. |
Displays child controls vertically or horizontally in a scrollable container. |
Represents a spacer control. It can be used to add a space between controls in a layout panel. It is not rendered on the client. |
Represents a split button control. |
Represents a data field that displays a list of selectable and removable tags. The control recognizes tags as the user types and adds in front of the editable field. |
Represent an upload widget. Allows users to selected one or more files and upload them to the server. |
Provides an popup container that can be attached to other controls. |
Provides a generic widget that can use most third party javascript widgets. |
Represents a list view control, which displays a collection of items that can be displayed using one of four different views. |
Represents a menu bar component. |
Provides a user interface for browsing the properties of an object. |
Displays information to the user in a about the object being viewed, the object's components, or the object's operation. |
Represents a toolbar component. |
Never | The data source is never updated and values entered into the control are not parsed, or re-formatted. |
OnPropertyChanged | The data source is updated whenever the value of the control property changes. |
OnValidation | The data source is updated when the control property is validated. |
Returns or sets a value that indicates when changes to the bound control property are propagated to the data source. |
Returns or sets the default for a 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, and adding the binding to the collection. |
Represents the method that will handle the event of the class. |
dataMember |
sender | The source of the event. |
e | An that contains the event data. |
Fired when the current item has been altered. |
Wisej.Web.PropertyManager
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Maintains a Binding between an object's property and a data-bound control property.
Object: Returns the object owning the data-bound property belongs.
Cancels the current edit.
Ends the current edit operation.
Resumes data binding.
Suspends the data binding between a data source and a data-bound property.
Wisej.Web.ListBindingHelper
Namespace: Wisej.Web
Assembly: Wisej.Framework (2.5.0.0)
Provides functionality to discover a bindable list and the properties of the items contained in the list when they differ from the public properties of the object to which they bind.
Returns a list associated with the specified data source.
Parameter | Type | Description |
---|---|---|
Returns: Object. An Object representing the underlying list if it exists; otherwise, the original data source specified by list .
Returns an object, typically a list, from the evaluation of a specified data source and optional data member.
Parameter | Type | Description |
---|---|---|
Returns: Object. An Object representing the underlying list if it was found; otherwise, dataSource .
Throws:
ArgumentException The specified data member name did not match any of the properties found for the data source.
Returns the PropertyDescriptorCollection that describes the properties of an item type contained in a specified data source, or properties of the specified data source.
Returns: PropertyDescriptorCollection. The PropertyDescriptorCollection containing the properties of the items contained in list , or properties of list..
Returns the PropertyDescriptorCollection that describes the properties of an item type contained in a collection property of a data source. Uses the specified PropertyDescriptor array to indicate which properties to examine.
Returns: PropertyDescriptorCollection. The PropertyDescriptorCollection describing the properties of the item type contained in a collection property of the data source.
Returns the PropertyDescriptorCollection that describes the properties of an item type contained in the specified data member of a data source. Uses the specified PropertyDescriptor array to indicate which properties to examine.
Returns: PropertyDescriptorCollection. The PropertyDescriptorCollection describing the properties of an item type contained in a collection property of the specified data source.
Throws:
ArgumentException The specified data member could not be found in the specified data source.
Returns the data type of the items in the specified list.
Returns: Type. The Type of the items contained in the list.
Returns the data type of the items in the specified data source.
Returns: Type. For complex data binding, the Type of the items represented by the dataMember in the data source; otherwise, the Type of the item in the list itself.
Returns the name of an underlying list, given a data source and optional PropertyDescriptor array.
Returns: String. The name of the list in the data source, as described by listAccessors , or the name of the data source type.
An that provides a format context.
A . If null is passed, the current culture is assumed.
The to convert.
The to convert the value parameter to.
An that provides a format context.
An of new property values.
An that provides a format context.
An that provides a format context.
A that represents the type you want to convert to.
Displays a in which a check box is displayed to the left of each item.
Provides a common implementation of members for the and classes.
Enables the user to select a single option from a group of choices when paired with other controls.
Creates a panel that is associated with a .
Manages a related set of pages.
Represents a single tab page in a .
Represents a control that can be hosted in a .
Represents a control that can be hosted in a .
Represents a control that can be hosted in a cell.
Represents a control that can be hosted in a .
Represents a control that can be hosted in a cell when the cell's is set to .
Used by the control to display data at run time.
Displays collapsible set of panels for presenting information in a limited amount of space.
Represents a panel in a control.
Represents a control that can display flash applications.
The TreeViewComboBox control represents a control with a as the drop down panel.
Represents a control that displays a video file.
Represents a control that plays an audio file.
Represents a control that can display a pdf document in the browser either using the native pdf viewer, the pdf.js viewer, Google docs, or a custom viewer.
Represents a spinner control that displays values.
The TreeViewComboBox control represents a control with a as the drop down panel.
The UserComboBox control represents a control with a custom panel that drops down when the user clicks the down arrow.
Displays a hierarchical collection of labeled items, each represented by a .
The name of the column or list, within the data source, to obtain the for.
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
Parameter | Type | Description |
---|---|---|
list
The data source to examine for property information.
list
The data source to be examined for property information.
listAccessors
The PropertyDescriptor array describing which properties of the data source to examine. This can be null.
dataSource
The data source to be examined for property information.
dataMember
The optional data member to be examined for property information. This can be null.
listAccessors
The PropertyDescriptor array describing which properties of the data member to examine. This can be null.
list
The list to be examined for type information.
dataSource
The data source to examine for items.
dataMember
The optional name of the property on the data source that is to be used as the data member. This can be null.
list
The data source to examine for the list name.
listAccessors
An array of PropertyDescriptor objects to find in the data source. This can be null.
list
The data source to examine for its underlying list.
dataSource
The data source from which to find the list.
dataMember
The name of the data source property that contains the list. This can be null.