ListView.OnSorting Method (ListViewSortEventArgs)


Raises the Sorting event.

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

protected virtual void OnSorting(
	ListViewSortEventArgs e


Type: System.Web.UI.WebControls.ListViewSortEventArgs

The event data.

Exception Condition

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 NIB: 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
Available since 3.5
Return to top