System.Windows.Forms 1.0.5000.0 2.0.0.0 System.Object The enables the synchronization of data-bound controls on a Windows Form that are bound to the same data source. (For more information about simple binding a control to a data source, see the class.) For example, suppose that a form contains two controls that are bound to the same data source but to different columns. The data source might be a that contains customer names, while the columns might contain the first and last names. The two controls must be synchronized in order to display the correct first and last names together for the same customer. The , which inherits from the class, accomplishes this synchronization by maintaining a pointer to the current item in the data source. The controls are bound to the current item so they display the information for the same row. When the current item changes, the notifies all the bound controls so that they can refresh their data. Furthermore, you can set the property to specify the row in the that the controls point to. To determine how many rows exist in the data source, use the property. The is necessary because data sources do not necessarily maintain a current-item pointer. For instance, arrays and objects can be data sources, but they do not have a property that returns the current item. To get the current item, use the property. The also inherits from the , and it is used to maintain the current property of an object, rather than the property of a current object in a data source. For this reason, trying to set the or property for a has no effect. To create a , use the class, which returns either a or a , depending on the data source being managed. Solutions programmers are encouraged to bind controls directly to a component, which acts as both a data source and data connector to the actual target data source. greatly simplifies both simple and complex data binding, including managing currency between the control and its target.

Manages all objects that are bound to the same data source and data member. This class is abstract.

Constructor The default constructor sets the property to null.

Initializes a new instance of the class.

1.0.5000.0 2.0.0.0 Method System.Void The method adds a new item to the underlying list by using the default constructor for that item's type. is intended primarily to be used by programmers adding complex data-binding support to their custom component. is commonly implemented using the following pattern that allows application programmers to inject their own code for creating customized items: raises the event. The programmer can supply a custom item by handling the event and setting the property of the parameter to the new item. Otherwise, the component should create an item using the default constructor. If the data source does not implement the interface, the item is immediately added to the data source and underlying list. If this interface is supported, then the addition is transacted by the and methods.

When overridden in a derived class, adds a new item to the underlying list.

1.0.5000.0 2.0.0.0 Event 2.0.0.0 System.Windows.Forms.BindingCompleteEventHandler The event occurs after the completion of a data-binding operation, which may include the following: Pushing information from the data source into the property of its bound control. Pulling information from a bound control into its associated data source. Note that this event is raised regardless of the completion status of the binding operation, although this status can be determined by examining the property of the parameter associated with the event. may also contain error and exception information. For example, a binding operation that attempts to push a null value from a data source into a control will generate an exception, since a cannot be null. In this case, although the binding operation does not successfully complete, the event will be raised, and the event will contain information on the failed binding attempt.

Occurs at the completion of a data-binding operation.

Property System.Windows.Forms.BindingsCollection To be added. To be added.

Gets the collection of bindings being managed.

1.0.5000.0 2.0.0.0 Method System.Void This method is supported only if the data source implements the interface. If the object does not implement the interface, changes made to the data will not be discarded. Calling the method causes the event to occur.

When overridden in a derived class, cancels the current edit.

1.0.5000.0 2.0.0.0 Property System.Int32 To be added. Use the property to determine the last item in the list of rows maintained by the . To go to the last item, set the property to the property value minus 1.

When overridden in a derived class, gets the number of rows managed by the .

1.0.5000.0 2.0.0.0 Property System.Object To be added. The object contains the value of the current item in the data source. To use the value of the current item, you must cast the item to the of the object contained by the . For example, a contains objects. To determine the type of the current object, use the and methods. When the is a , , or , you are actually binding to a . Consequently, each object is a object.

When overridden in a derived class, gets the current object.

1.0.5000.0 2.0.0.0 Event System.EventHandler The event is raised whenever the property changes or the event occurs. For more information about handling events, see Consuming Events.

Occurs when the currently bound item changes.

1.0.5000.0 2.0.0.0 Event 2.0.0.0 System.EventHandler The event occurs whenever there is a change in the state in the currently bound item. This can occur if one of the properties of this item is changed or if the item itself is replaced or moved.

Occurs when the state of the currently bound item changes.

Event 2.0.0.0 System.Windows.Forms.BindingManagerDataErrorEventHandler This event is informational and reports Common Language Specification (CLS)-compliant exceptions only. To determine what type of exception occurred, handle this event and check the property of the . For more information about handling events, see Consuming Events.

Occurs when an is silently handled by the .

Method System.Void This method is supported only if the data source implements the interface. In that case, changes will be saved. If the object does not implement the interface, changes made to the data will not be saved.

When overridden in a derived class, ends the current edit.

1.0.5000.0 2.0.0.0 Method System.ComponentModel.PropertyDescriptorCollection To be added.

When overridden in a derived class, gets the collection of property descriptors for the binding.

A that represents the property descriptors for the binding. 1.0.5000.0 2.0.0.0 Method 1.0.5000.0 2.0.0.0 System.ComponentModel.PropertyDescriptorCollection This method is used by developers creating data-bound controls.

Gets the collection of property descriptors for the binding using the specified .

A that represents the property descriptors for the binding. An containing the data sources. An containing the table's bound properties. Method System.ComponentModel.PropertyDescriptorCollection This overload is used by developers to create data-bound controls.

Gets the list of properties of the items managed by this .

A that represents the property descriptors for the binding. The of the bound list. A counter used to recursively call the method. An containing the data sources. An containing the table's bound properties. 1.0.5000.0 2.0.0.0 Method 1.0.5000.0 2.0.0.0 System.String To be added.

When overridden in a derived class, gets the name of the list supplying the data for the binding.

The name of the list supplying the data for the binding. An containing the table's bound properties. Property 2.0.0.0 System.Boolean To be added. To be added.

Gets a value indicating whether binding is suspended.

Method 2.0.0.0 System.Void Raising an event invokes the event handler through a delegate. For more information, see Raising an Event. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Raises the event.

A that contains the event data. Method 1.0.5000.0 2.0.0.0 System.Void Raising an event invokes the event handler through a delegate. For more information, see Raising an Event. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Raises the event.

The that contains the event data. Field System.EventHandler To be added.

Specifies the event handler for the event.

1.0.5000.0 2.0.0.0 Method 2.0.0.0 System.Void Raising an event invokes the event handler through a delegate. For more information, see Raising an Event. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Raises the event.

The that contains the event data. Method 2.0.0.0 System.Void Raising an event invokes the event handler through a delegate. For more information, see Raising an Event. The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Raises the event.

An that caused the event to occur. Field System.EventHandler To be added.

Specifies the event handler for the event.

1.0.5000.0 2.0.0.0 Property System.Int32 To be added. Use the property to iterate through the underlying list maintained by the . To go to the first item, set the to 0. To go to the end of the list, set the to the value of the property minus 1. The event occurs when the property value changes.

When overridden in a derived class, gets or sets the position in the underlying list that controls bound to this data source point to.

1.0.5000.0 2.0.0.0 Event System.EventHandler For more information about handling events, see Consuming Events.

Occurs after the value of the property has changed.

1.0.5000.0 2.0.0.0 Method System.Void The method is a programmatic way to pull information from the data-bound control back into the data source. It is not required for standard operation of a control, since normally a control automatically updates its bound data source when focus leaves it. raises the event and change events on the data source as appropriate.

Pulls data from the data-bound control into the data source, returning no information.

1.0.5000.0 2.0.0.0 Method System.Void The method is a programmatic way to push information from the data source into the data-bound control. This method is not required if the data source implements the interface, because the event should automatically cause the control to be updated through its currency manager. If this method is issued when a operation is being performed, the method returns immediately with a value of true.

Pushes data from the data source into the data-bound control, returning no information.

1.0.5000.0 2.0.0.0 Method System.Void The method relies on the underlying data source to determine how the method behaves. (See the class for a list of supported data sources.) For classes that implement , , or , as well as strongly typed classes that implement , the method actually deletes the row in the underlying list instead of removing its contents. If the underlying list implements the interface, the property must return true. If the underlying list implements the interface, the property must return false.

When overridden in a derived class, deletes the row at the specified index from the underlying list.

The index of the row to delete. 1.0.5000.0 2.0.0.0 Method System.Void and are two methods that allow the temporary suspension and resumption of data binding. You would typically suspend data binding if the user must be allowed to edit data fields before validation occurs. For example, the user might need to change a field to be in accordance with a second field; otherwise, validating the first field would cause the second field to be in error.

When overridden in a derived class, resumes data binding.

1.0.5000.0 2.0.0.0 Method System.Void and are two methods that allow the temporary suspension and resumption of data binding. You would typically suspend data binding if the user must be allowed to edit data fields before validation occurs. For example, the user might need to change a field to be in accordance with a second field; otherwise, validating the first field would cause the second field to be in error.

When overridden in a derived class, suspends data binding.

1.0.5000.0 2.0.0.0 Method System.Void The method updates the data binding between the bound control and its data source. For complex data-binding scenarios, it also resets the current position to the beginning of the underlying list.

When overridden in a derived class, updates the binding.

1.0.5000.0 2.0.0.0