DataBoundControl.OnDataSourceViewChanged(Object, EventArgs) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 -> unitProtected Overridable Sub OnDataSourceViewChanged (sender As Object, e As EventArgs)Parameters
- sender
- Object
The source of the event, the DataSourceView.
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.
