DataBoundControl.OnDataSourceViewChanged(Object, EventArgs) Method

Definition

Raises the DataSourceViewChanged event.

protected:
 virtual void OnDataSourceViewChanged(System::Object ^ sender, EventArgs ^ e);
protected virtual void OnDataSourceViewChanged (object sender, EventArgs e);
abstract member OnDataSourceViewChanged : obj * EventArgs -> unit
override this.OnDataSourceViewChanged : obj * EventArgs -> unit
Protected Overridable Sub OnDataSourceViewChanged (sender As Object, e As EventArgs)

Parameters

sender
Object

The source of the event, the DataSourceView.

e
EventArgs

An EventArgs that contains event data.

Remarks

The OnDataSourceViewChanged method notifies a data-bound control that the underlying data source has changed and that the control should rebind and any necessary work should be performed. Typically, the OnDataSourceViewChanged method is called when a property of the data source view has changed.

The DataBoundControl class sets the RequiresDataBinding property to true when it raises the DataSourceViewChanged event.

Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.

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

Notes to Inheritors

When overriding OnDataSourceViewChanged(Object, EventArgs) in a derived class, be sure to call the base class's OnDataSourceViewChanged(Object, EventArgs) method so that registered delegates receive the event.

Applies to