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 ist nicht mithilfe der DataSourceID Eigenschaft an ein Datenquellensteuerelement gebunden.

Hinweise

Das ListView Steuerelement löst das ItemInserting Ereignis aus, wenn auf eine Einfügeschaltflä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.) Auf diese Weise können Sie eine benutzerdefinierte Routine ausführen, wenn dieses Ereignis eintritt, z. B. HTML-Codierung oder Validieren der Werte eines Datensatzes, bevor es in die Datenquelle eingefügt wird.

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

Das Auslösen eines Ereignisses ruft den Ereignishandler über einen Delegaten auf. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.

Mit der OnItemInserting Methode können abgeleitete Klassen auch das Ereignis behandeln, ohne einen Delegaten anzufügen. Dies ist die bevorzugte Technik für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

Wenn Sie in einer abgeleiteten Klasse außer Kraft setzen OnItemInserting(ListViewInsertEventArgs) , rufen Sie die Methode der Basisklasse OnItemInserting(ListViewInsertEventArgs) auf, damit registrierte Stellvertretungen das Ereignis empfangen.

Gilt für:

Weitere Informationen