Export (0) Print
Expand All

HtmlSelect.OnDataBinding Method

Raises the DataBinding event of an HtmlSelect control.

Namespace:  System.Web.UI.HtmlControls
Assembly:  System.Web (in System.Web.dll)

protected override void OnDataBinding(
	EventArgs e
)

Parameters

e
Type: System.EventArgs

A System.EventArgs that contains the event data.

ExceptionCondition
HttpException

The DataSourceID property is not of type IDataSource.

- or -

The DataSourceID property is not of type IHierarchicalDataSource.

InvalidOperationException

Both a DataSource and a DataSourceID property are defined for the HtmlSelect control.

- or -

The requested data view cannot be found.

ArgumentOutOfRangeException

The SelectedIndex property was set to a value greater than the number of items in the HtmlSelect control or less than -1.

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 Raising an Event.

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 method in a derived class, be sure to call the base class's OnDataBinding method so that registered delegates receive the event.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft