HtmlSelect.OnDataBinding(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 DataBinding event of an HtmlSelect control.
protected:
override void OnDataBinding(EventArgs ^ e);
protected override void OnDataBinding (EventArgs e);
override this.OnDataBinding : EventArgs -> unit
Protected Overrides Sub OnDataBinding (e As EventArgs)
Parameters
Exceptions
The DataSourceID property is not of type IDataSource.
-or-
The DataSourceID property is not of type IHierarchicalDataSource.
Both a DataSource and a DataSourceID property are defined for the HtmlSelect control.
-or-
The requested data view cannot be found.
The SelectedIndex property was set to a value greater than the number of items in the HtmlSelect control or less than -1
.
Remarks
The DataBinding event is raised when data is bound to the HtmlSelect control. This method notifies the control to perform any data-binding logic that is associated with it. Specifically, the OnDataBinding method creates the Items collection from the data source specified in either the DataSource property or the DataSourceID property.
Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.
The OnDataBinding 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 the OnDataBinding(EventArgs) method in a derived class, be sure to call the base class's OnDataBinding(EventArgs) method so that registered delegates receive the event.