GridView.OnSelectedIndexChanging(GridViewSelectEventArgs) Método

Definição

Aciona o evento SelectedIndexChanging.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)

Parâmetros

e
GridViewSelectEventArgs

Um GridViewSelectEventArgs que contém dados do evento.A GridViewSelectEventArgs that contains event data.

Comentários

O SelectedIndexChanging evento é gerado quando um botão de seleção de uma linha é clicado, mas antes que o GridView controle manipule a operação de seleção.The SelectedIndexChanging event is raised when a row's Select button is clicked, but before the GridView control handles the select operation. Isso permite que você forneça um método de manipulação de eventos que executa uma rotina personalizada, como cancelar a operação de seleção, sempre que esse evento ocorrer.This enables you to provide an event-handling method that performs a custom routine, such as canceling the selection operation, whenever this event occurs.

A geração de um evento invoca o manipulador de eventos por meio de um delegado.Raising an event invokes the event handler through a delegate. Para obter mais informações, consulte manipulando e gerando eventos.For more information, see Handling and Raising Events.

O OnSelectedIndexChanging método também permite que classes derivadas manipulem o evento sem anexar um delegado.The OnSelectedIndexChanging method also allows derived classes to handle the event without attaching a delegate. Essa é a técnica preferida para manipular o evento em uma classe derivada.This is the preferred technique for handling the event in a derived class.

Notas aos Herdeiros

Ao substituir OnSelectedIndexChanging(GridViewSelectEventArgs) em uma classe derivada, certifique-se de chamar o método da classe base OnSelectedIndexChanging(GridViewSelectEventArgs) para que os delegados registrados recebam o evento.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.

Aplica-se a

Confira também