ListView.OnItemCanceling(ListViewCancelEventArgs) Método

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.Extensions.dll

Aciona o evento ItemCanceling.

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

Parâmetros

e
ListViewCancelEventArgs

Os dados do evento.

Exceções

InvalidOperationException

Não há nenhum manipulador para o evento ItemCanceling.

Comentários

O ListView controle aciona o ItemCanceling evento quando um botão Cancelar no controle é clicado, mas antes de sair do modo de inserção ou edição. (Um botão Cancelar é um controle de botão cuja CommandName propriedade está definida como "Cancelar".) Isso permite que você execute uma rotina personalizada sempre que esse evento ocorrer, como interromper a operação de cancelamento se ele colocar o item em um estado indesejado.

O OnItemCanceling método é chamado pelo ListView controle para acionar o ItemCanceling evento. Normalmente, ele é usado por desenvolvedores de controle ao estender a ListView classe.

A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte Manipulando e gerando eventos.

O OnItemCanceling método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.

Notas aos Herdeiros

Ao substituir OnItemCanceling(ListViewCancelEventArgs) em uma classe derivada, chame o método da OnItemCanceling(ListViewCancelEventArgs) classe base para que os delegados registrados recebam o evento.

Aplica-se a

Confira também