Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Provides data for the BindingComplete event.

public class BindingCompleteEventArgs : CancelEventArgs

Public Class BindingCompleteEventArgs
    Inherits CancelEventArgs

Constructors

BindingCompleteEventArgs(binding, state, context, errorText, exception, cancel)

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.

BindingCompleteEventArgs(binding, state, context, errorText, exception)

Initializes a new instance of the BindingCompleteEventArgs class with the specified binding, error state and text, binding context, and exception.

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.

Properties

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.

Used By

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Specifies the direction of the binding operation.

public enum BindingCompleteContext : Enum

Public Enum BindingCompleteContext As [Enum]

Fields

Used By

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Represents the delegate that handles the BindingComplete event.

public delegate void BindingCompleteEventHandler(Object sender, BindingCompleteEventArgs e)

Public Delegate Sub BindingCompleteEventHandler(ByVal sender As [Object], ByVal e As BindingCompleteEventArgs)

Parameters

Fired By

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Manages all Binding objects that are bound to the same data source and data member.

public class BindingManagerBase

Public Class BindingManagerBase

Properties

Bindings

BindingsCollection: Returns the collection of bindings being managed.

Count

Int32: Returns the number of items in the list.

Current

Object: Returns the current item in the list.

IsBindingSuspended

Boolean: Returns whether binding is suspended.

Position

Int32: Returns or sets the position of the data binding source within the list.

Methods

Adds a new item to the underlying list.

Throws:

• NotSupportedException The underlying data source does not implement IBindingList, or the data source has thrown an exception because the user has attempted to add a row to a read-only or fixed-size DataView.

Cancels the current edit operation.

Ends the current edit operation.

Returns the property descriptor collection for the underlying list.

Returns: PropertyDescriptorCollection. A PropertyDescriptorCollection for the list.

Removes the item at the specified index.

Throws:

• IndexOutOfRangeException There is no row at the specified index .

Causes a control bound to this data source to re-read the current item and refresh the displayed value.

Causes a control bound to this data source to re-read the item at the specified itemIndex and refresh the displayed value.

Resumes data binding.

Suspends data binding to prevents changes from updating the bound data source.

Reads the current values from the data source and sends them to the control.

Events

BindingCompleteEventHandler Fired at the completion of a data-binding operation.

EventHandler Fired when the currently bound item changes.

EventHandler Fired when the state of the currently bound item changes.

BindingManagerDataErrorEventHandler Fired when an Exception is silently handled by the BindingManagerBase.

EventHandler Fired after the value of the Position property has changed.

Inherited By

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Manages the collection of BindingManagerBase objects for any object that inherits from the Control class.

public class BindingContext : BindingContext

Public Class BindingContext
    Inherits BindingContext

Constructors

BindingContext()

Creates a new instance of BindingContext.

Properties

IsReadOnly

Boolean: Returns whether the collection is read-only.

Item(dataSource)

BindingManagerBase: Returns the BindingManagerBase that is associated with the data source.

Item(dataSource, dataMember)

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.

Methods

Adds the BindingManagerBase associated with a specific data source to the collection.

Throws:

• ArgumentNullException dataSource is null, or listManager is null.

Adds the BindingManagerBase associated with a specific data source to the collection.

Throws:

• ArgumentNullException dataSource is null, or listManager is null.

Clears the collection of any BindingManagerBase objects.

Clears the collection of any BindingManagerBase objects.

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.

Removes the BindingManagerBase associated with the specified dataSource .

Removes the BindingManagerBase associated with the specified dataSource .

Associates a Binding with a new BindingContext.

Events

CollectionChangeEventHandler Fired when the collection of data sources changes.

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Provides data for the DataError event.

public class BindingManagerDataErrorEventArgs : EventArgs

Public Class BindingManagerDataErrorEventArgs
    Inherits EventArgs

Constructors

BindingManagerDataErrorEventArgs(exception)

Initializes a new instance of the BindingManagerDataErrorEventArgs class.

Properties

Exception

Exception: Returns the Exception caught in the binding process.

Used By

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.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.

public struct BindingMemberInfo : ValueType

Public Structure BindingMemberInfo
    Implements ValueType

Constructors

BindingMemberInfo(dataMember)

Initializes a new instance of the BindingMemberInfo class.

Properties

BindingField

String: Returns the property name of the data-bound object.

BindingMember

String: Returns the information that is used to specify the property name of the data-bound object.

BindingPath

String: Returns the property name, or the period-delimited hierarchy of property names, that comes before the property name of the data-bound object.

Used By

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Represents the method that will handle the DataError event.

public delegate void BindingManagerDataErrorEventHandler(Object sender, BindingManagerDataErrorEventArgs e)

Public Delegate Sub BindingManagerDataErrorEventHandler(ByVal sender As [Object], ByVal e As BindingManagerDataErrorEventArgs)

Parameters

Fired By

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

• Control

  • ScrollableControl

    • Panel

      • FlowLayoutPanel

        • BindingNavigator

Represents the navigation and manipulation user interface (UI) for controls that are bound to a data source.

public class BindingNavigator : FlowLayoutPanel, ISupportInitialize

Public Class BindingNavigator
    Inherits FlowLayoutPanel
    Implements ISupportInitialize

Constructors

BindingNavigator(bindingSource)

Initializes a new instance of the BindingNavigator class with the specified BindingSource as the data source.

BindingNavigator(addStandardItems)

Initializes a new instance of the BindingNavigator class, indicating whether to display the standard navigation user interface (UI).

Properties

Button: Returns or sets the "Add New" button.

BindingSource: Returns or sets the BindingSource component that is the source of data. (Default: null)

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. (Default: "")

Methods

Adds the standard set of navigation items to the BindingNavigator control.

Disables updates to the controls of during the component's initialization.

Clean up any resources being used.

Enables updates to the controls after the component's initialization has completed.

Fires the DockChanged event.

Fires the RefreshItems event.

Fires the TextChanged event.

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.

Events

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.

Implements

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Indicates the result of a binding operation.

public enum BindingCompleteState : Enum

Public Enum BindingCompleteState As [Enum]

Fields

Used By

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

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

public class Binding : Binding, IBinding

Public Class Binding
    Inherits Binding
    Implements IBinding

Constructors

Binding(propertyName, dataSource, dataMember)

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

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.

Binding(propertyName, dataSource, dataMember, formattingEnabled)

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.

Throws:

Throws:

Throws:

Throws:

Throws:

Properties

Methods

Sets the control property to the value read from the data source.

Reads the current value from the control property and writes it to the data source.

Events

Implements

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Implements the interface wrapping execute and canExecute actions.

public class Command<T> : Command

Public Class Command(Of T)
    Inherits Command

You can use this class to wrap custom commands to bind to controls that implement the interface and need to access the typed data source records. In the snippet below, the CommandDemoViewModel class derives from BindingList<Customer> and allows the commands to directly interact with the typed property.

public CommandDemoViewModel : BindingList<Person>
{
  
  public Wisej.Web.ICommand SaveCommand { get; }
  
  public CommandDemoViewModel()
  {
    this.SaveCommand = new Command<Person>(
      execute: args => {
        DB.Save(args.DataItem);
      },
      canExecute: args => {
        return  args.DataItem.Name != null &&
            args.DataItem.Age > 0;
      });
  }
}

Parameters

Constructors

Implements

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Represents a collection of objects for a control.

public class BindingsCollection : ICollection, IEnumerable

Public Class BindingsCollection
    Inherits ICollection
    Implements IEnumerable

Properties

Count

: Returns the total number of bindings in the collection.

Item(index)

: Returns the at the specified index.

Throws:

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

Methods

ReadValues()

Reads the current values from the data source and sends them to the control.

Takes the current values from the control and writes them to the data source.

Events

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Implements the ICommand interface wrapping execute and canExecute actions.

public class Command : ICommand

Public Class Command
    Inherits ICommand

You can use this class and Command to wrap custom commands to bind to controls that implement the ICommandSource interface. A view model class can expose as many commands as you like. You can bind (or assign) a command to the Command property (see Command for example).

public CommandDemoViewModel : INotifyPropertyChanged
{
  public event PropertyChangedEventHandler PropertyChanged;
  
  public int Number { ... }
  
  public Wisej.Web.ICommand AddCommand { get; }
  
  public CommandDemoViewModel()
  {
    this.AddCommand = new Command(args => this.Number++);
    
    // Or
    this.AddCommand = new Command(
      execute: args => this.Number++,
      canExecute: args => this.Number < 10
    );
  }
}

Now you can use data binding or a code assignment to connect the view model's Add command to a button's Command property.

Constructors

Initializes a new Command wrapping am execute method and an canExecute method.

Initializes a new Command wrapping am execute method and an canExecute method.

Methods

Executes a method that determines whether the command can execute in its current state.

Returns: Boolean. true if this command can be executed; otherwise, false.

Executes the command method.

Fires the CanExecuteChanged event.

Events

EventHandler Fired when the result of the CanExecute method changes.

Inherited By

Implements

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Encapsulates the data source for a data-bound component.

public class BindingSource : BindingSource, ICurrencyManagerProvider

Public Class BindingSource
    Inherits BindingSource
    Implements ICurrencyManagerProvider

Constructors

BindingSource()

Initializes a new instance of the BindingSource class to the default property values.

BindingSource(container)

Initializes a new instance of the BindingSource class and adds the BindingSource to the specified container.

BindingSource(dataSource, dataMember)

Initializes a new instance of the BindingSource class with the specified data source and data member.

BindingSource(dataSource)

Initializes a new instance of the BindingSource class with the specified data source.

Properties

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. (Default: "")

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. (Default: null)

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.

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. (Default: null)

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.

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. (Default: -1)

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. (Default: True)

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. (Default: False)

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. (Default: null)

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.

Methods

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 property does not match a property in the list.

Retrieves the collection of PropertyDescriptor objects representing the bindable ICommand properties defined on the DataSource object.

Returns: PropertyDescriptorCollection. An collection of PropertyDescriptor objects that represents the commands on the data source.

Retrieves an enumerator for the underlying List.

Returns: IEnumerator. An IEnumerator for the List.

Retrieves an collection of PropertyDescriptor objects representing the bindable properties of the data source list type.

Returns: PropertyDescriptorCollection. An collection 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.

Fires the AddingNew event.

Fires the BindingComplete event.

Fires the CurrentChanged event.

Fires the CurrentItemChanged event.

Fires the DataError event.

Fires the DataMemberChanged event.

Fires the DataSourceChanged event.

Fires the ListChanged event.

Fires the PositionChanged event.

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

Events

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.

Implements

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Represents data passed to ICommand.

public class CommandArgs

Public Class CommandArgs

Constructors

CommandArgs(dataItem, commandSource, bindingContext, currencyManager)

Initializes a new instance of CommandArgs.

All arguments are optional.

Properties

BindingContext

BindingContext: Returns or sets the current BindingContext.

ICommandSource: Returns or sets the ICommandSource that invoked the command.

CurrencyManager: Returns or sets the current CurrencyManager.

Object: Returns or sets the current data item.

Inherited By

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

• CommandArgs

  • CommandArgs<T>

Represents typed data passed to ICommand.

public class CommandArgs<T> : CommandArgs

Public Class CommandArgs(Of T)
    Inherits CommandArgs

Parameters

Constructors

CommandArgs()

Initializes a new CommandArgs.

CommandArgs(args)

Initializes a new CommandArgs.

Properties

T: Returns or sets the current data item.

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Determines when changes to a data source value are updated in the data-bound control.

public enum ControlUpdateMode : Enum

Public Enum ControlUpdateMode As [Enum]

Fields

Used By

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Represents the collection of data bindings for a IBindableComponent.

public class ControlBindingsCollection : ControlBindingsCollection

Public Class ControlBindingsCollection
    Inherits ControlBindingsCollection

Constructors

ControlBindingsCollection(component)

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

Properties

BindableComponent

IBindableComponent: Returns the IBindableComponent associated the binding collection.

Control

Control: Returns the Control that the collection belongs to.

DefaultDataSourceUpdateMode

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.

Methods

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.