ListView.OnItemInserting(ListViewInsertEventArgs) Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

InvalidOperationException

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 wird oder die InsertNewItem -Methode aufgerufen wird, aber bevor das ListView Steuerelement den Datensatz einfügt. (Eine Einfügen-Schaltfläche ist ein Schaltflächensteuerelement, dessen CommandName Eigenschaft auf "Einfügen" festgelegt ist.) Dadurch können Sie eine benutzerdefinierte Routine ausführen, wenn dieses Ereignis auftritt, z. B. HTML-Codierung oder Ü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 auch abgeleiteten Klassen, das Ereignis zu behandeln, ohne einen Delegaten anzufügen. 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: