Freigeben über


ListView.OnItemInserting(ListViewInsertEventArgs) Methode

Definition

Löst das ItemInserting-Ereignis aus.

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)

Parameter

e
ListViewInsertEventArgs

Die Ereignisdaten.

Ausnahmen

Das ListView-Steuerelement wird nicht mithilfe der DataSourceID-Eigenschaft an ein Datenquellensteuerelement gebunden.

Hinweise

Das ListView -Steuerelement löst das ItemInserting Ereignis aus, wenn auf eine Einfügen-Schaltfläche im Steuerelement geklickt oder die InsertNewItem -Methode aufgerufen wird, aber bevor das ListView Steuerelement den Datensatz einfügt. (Eine Schaltfläche Einfügen ist ein Schaltflächensteuerelement, dessen CommandName Eigenschaft auf "Einfügen" festgelegt ist.) Dadurch können Sie immer dann eine benutzerdefinierte Routine ausführen, wenn dieses Ereignis auftritt, z. B. die HTML-Codierung oder das Überprüfen der Werte eines Datensatzes, bevor er in die Datenquelle eingefügt wird.

Die OnItemInserting -Methode wird vom ListView -Steuerelement aufgerufen, um das Ereignis auszulösen ItemInserting . Sie wird in der Regel von Steuerelemententwicklern beim Erweitern der ListView -Klasse verwendet.

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.

Die OnItemInserting -Methode ermöglicht es auch abgeleiteten Klassen, das Ereignis ohne Anfügen eines Delegaten zu behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

Wenn Sie in einer abgeleiteten Klasse überschreiben OnItemInserting(ListViewInsertEventArgs) , rufen Sie die Methode der Basisklasse OnItemInserting(ListViewInsertEventArgs) auf, damit registrierte Delegaten das Ereignis empfangen.

Gilt für:

Weitere Informationen