System.Windows.Forms.BindingManagerBase.BindingComplete Event

Occurs at the completion of a data-binding operation.

Syntax

public event BindingCompleteEventHandler BindingComplete

Remarks

The BindingManagerBase.BindingComplete 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 BindingCompleteEventArgs.BindingCompleteState property of the System.Windows.Forms.BindingCompleteEventArgs parameter associated with the event. System.Windows.Forms.BindingCompleteEventArgs 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 System.Windows.Forms.DateTimePicker control will generate an exception, since a DateTime cannot be null. In this case, although the binding operation does not successfully complete, the BindingManagerBase.BindingComplete event will be raised, and the event will contain information on the failed binding attempt.

Requirements

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Assembly Versions: 2.0.0.0