GridView.OnSelectedIndexChanging(GridViewSelectEventArgs) Method

Definition

Raises the SelectedIndexChanging event.

protected:
 virtual void OnSelectedIndexChanging(System::Web::UI::WebControls::GridViewSelectEventArgs ^ e);
protected virtual void OnSelectedIndexChanging (System.Web.UI.WebControls.GridViewSelectEventArgs e);
abstract member OnSelectedIndexChanging : System.Web.UI.WebControls.GridViewSelectEventArgs -> unit
override this.OnSelectedIndexChanging : System.Web.UI.WebControls.GridViewSelectEventArgs -> unit
Protected Overridable Sub OnSelectedIndexChanging (e As GridViewSelectEventArgs)

Parameters

e
GridViewSelectEventArgs

A GridViewSelectEventArgs that contains event data.

Remarks

The SelectedIndexChanging event is raised when a row's Select button is clicked, but before the GridView control handles the select operation. This enables you to provide an event-handling method that performs a custom routine, such as canceling the selection operation, whenever this event occurs.

Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.

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

Applies to

See also