ListView::OnSorting Method (ListViewSortEventArgs^)
Raises the Sorting event.
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)
Parameters
- e
-
Type:
System.Web.UI.WebControls::ListViewSortEventArgs^
The event data.
| Exception | Condition |
|---|---|
| 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 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.
Available since 3.5