Export (0) Print
Expand All
Expand Minimize

ListView.OnSorting Method

Raises the Sorting event.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

protected virtual void OnSorting(
	ListViewSortEventArgs e
)

Parameters

e
Type: System.Web.UI.WebControls.ListViewSortEventArgs

The event data.

ExceptionCondition
InvalidOperationException

The ListView control is not bound to a data source control by using the DataSourceID property.

The Sorting event is raised when a Sort button is clicked or the Sort method is called, but before the ListView control handles the sort operation. (A Sort button is a button control whose CommandName property is set to "Sort".) This enables you to perform a custom routine whenever this event occurs, such as canceling the sorting operation.

Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

The OnSorting method also enables 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 you override OnSorting in a derived class, call the base class's OnSorting method so that registered delegates receive the event.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5
Show:
© 2015 Microsoft