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 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 Schaltfläche "Einfügen" 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üfung der Werte eines Datensatzes, bevor es in die Datenquelle eingefügt wird.

Die OnItemInserting Methode wird vom Steuerelement aufgerufen, um das ListView ItemInserting Ereignis zu auslösen. 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.

Mit der OnItemInserting Methode können abgeleitete Klassen auch das Ereignis behandeln, ohne eine Stellvertretung 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 außer Kraft OnItemInserting(ListViewInsertEventArgs) setzen, rufen Sie die Methode der Basisklasse OnItemInserting(ListViewInsertEventArgs) auf, sodass registrierte Stellvertretungen das Ereignis erhalten.

Gilt für: