ListView.OnItemInserting(ListViewInsertEventArgs) Método

Definição

Eleva o ItemInserting evento.

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

Parâmetros

e
ListViewInsertEventArgs

Os dados do evento.

Exceções

O ListView controlo não está vinculado a um controlo de fonte de dados ao usar a DataSourceID propriedade.

Observações

O ListView controlo levanta o ItemInserting evento quando um botão Insert no controlo é clicado ou o InsertNewItem método é chamado, mas antes do ListView controlo inserir o registo. (Um botão Inserir é um controlo de botão cuja CommandName propriedade está definida como "Inserir".) Isto permite-lhe executar uma rotina personalizada sempre que este evento ocorre, como codificação HTML ou validação dos valores de um registo antes de este ser inserido na fonte de dados.

O OnItemInserting método é chamado pelo ListView controlo para elevar o ItemInserting evento. É normalmente utilizado pelos desenvolvedores de controlo ao estender a ListView classe.

Levantar um evento invoca o gestor de eventos através de um delegado. Para mais informações, consulte Manuseio e Levantamento de Eventos.

O OnItemInserting método também permite que classes derivadas tratem do evento sem anexar um delegado. Esta é a técnica preferida para lidar com o evento numa classe derivada.

Notas para Herdeiros

Quando sobrescreve OnItemInserting(ListViewInsertEventArgs) uma classe derivada, chama o método da OnItemInserting(ListViewInsertEventArgs) classe base para que os delegados registados recebam o evento.

Aplica-se a

Ver também