Seitenereignis | Typische Verwendung |
|---|
PreInit | Wird ausgelöst, nachdem die Startphase abgeschlossen ist und bevor die Initialisierungsphase beginnt. Verwenden Sie dieses Ereignis für folgende Vorgänge: Prüfen mithilfe der IsPostBack-Eigenschaft, ob die Seite zum ersten Mal verarbeitet wird. Zu diesem Zeitpunkt wurden auch die IsCallback-Eigenschaft und die IsCrossPagePostBack-Eigenschaft festgelegt. Erstellen oder erneutes Erstellen von dynamischen Steuerelementen. Dynamisches Festlegen einer Masterseite. Dynamisches Festlegen der Theme-Eigenschaft. Lesen oder Festlegen von Profileigenschaftswerten.  HinweisWenn es sich bei der Anforderung um ein Postback handelt, wurden die Werte der Steuerelemente noch nicht aus dem Ansichtszustand wiederhergestellt.Wenn Sie in dieser Phase eine Steuerelementeigenschaft festlegen, wird ihr Wert möglicherweise beim nächsten Ereignis überschrieben.
|
Init | Dieses Ereignis wird ausgelöst, nachdem alle Steuerelemente initialisiert und alle Skineinstellungen übernommen wurden. Das Init-Ereignis einzelner Steuerelemente tritt vor dem Init-Ereignis der Seite auf. Verwenden Sie dieses Ereignis zum Lesen oder Initialisieren von Steuerelementeigenschaften. |
InitComplete | Wird am Ende der Initialisierungsphase der Seite ausgelöst. Zwischen dem Init-Ereignis und dem InitComplete-Ereignis findet nur ein Vorgang statt: Die Verfolgung von Ansichtszustandsänderungen wird aktiviert. Die Verfolgung des Ansichtszustands aktiviert Steuerelemente, um beliebige Werte beizubehalten, die der ViewState-Auflistung programmgesteuert hinzugefügt werden. Bis die Nachverfolgung des Ansichtszustands aktiviert wird, gehen alle Werte, die dem Ansichtszustand hinzugefügt werden, über Postbacks verloren. Die Verfolgung des Ansichtszustands wird von Steuerelementen in der Regel aktiviert, nachdem das Init-Ereignis ausgelöst wurde. Verwenden Sie dieses Ereignis, um Änderungen am Ansichtszustand vorzunehmen, die nach dem nächsten Postback immer noch vorhanden sein sollen. |
PreLoad | Wird ausgelöst, nachdem die Seite den eigenen Ansichtszustand und den aller Steuerelemente geladen hat und nachdem Postbackdaten verarbeitet wurden, die in derRequest-Instanz enthalten sind. |
Load | Das Page-Objekt ruft die OnLoad-Methode für das Page-Objekt auf. Dieser Schritt wird rekursiv für alle untergeordneten Steuerelemente und deren untergeordnete Steuerelemente wiederholt, bis die Seite und die Steuerelemente vollständig geladen sind. Das Load-Ereignis einzelner Steuerelemente tritt nach dem Load-Ereignis der Seite auf. Verwenden Sie die OnLoad-Ereignismethode, um Eigenschaften in Steuerelementen festzulegen und Datenbankverbindungen herzustellen. |
Steuerelementereignisse | Verwenden Sie diese Ereignisse, um bestimmte Steuerelementereignisse zu verwalten, wie z. B. das Click-Ereignis eines Button-Steuerelements oder das TextChanged-Ereignis eines TextBox-Steuerelements. Hinweis Überprüfen Sie bei einer Postbackanforderung die IsValid-Eigenschaft von Page und einzelnen Validierungssteuerelemente vor der Verarbeitung, wenn die Seite Validierungssteuerelemente enthält. |
LoadComplete | Wird am Ende der Ereignisbehandlungsphase ausgelöst. Verwenden Sie dieses Ereignis für Aufgaben, für die alle anderen Steuerelemente auf der Seite geladen sein müssen. |
PreRender | Wird ausgelöst, nachdem das Page-Objekt alle Steuerelemente erstellt hat, die erforderlich sind, um die Seite, einschließlich untergeordneter Steuerelemente zusammengesetzter Steuerelemente, zu rendern. (Zu diesem Zweck wird die EnsureChildControls-Methode vom Page-Objekt für jedes Steuerelement und für die Seite aufgerufen.) Das Page-Objekt löst das PreRender-Ereignis auf dem Page-Objekt aus und führt den gleichen Vorgang dann rekursiv für jedes untergeordnete Steuerelement aus. Das PreRender-Ereignis einzelner Steuerelemente tritt nach dem PreRender-Ereignis der Seite auf. Verwenden Sie das Ereignis, um abschließende Änderungen am Inhalt der Seite oder an darin enthaltenen Steuerelementen vorzunehmen, bevor das Rendern beginnt. |
PreRenderComplete | Wird aufgerufen, nachdem jedes datengebundene Steuerelement, dessen DataSourceID-Eigenschaft festgelegt wurde, seine DataBind-Methode aufruft. Weitere Informationen finden Sie im Folgenden unter Datenbindungsereignisse für datengebundene Steuerelemente. |
SaveStateComplete | Wird ausgelöst, nachdem der Ansichtszustand und der Steuerelementzustand für die Seite und alle Steuerelemente gespeichert wurden. Alle Änderungen an der Seite oder den Steuerelementen haben zu diesem Zeitpunkt zwar Auswirkungen auf das Rendering, sie werden aber beim nächsten Postback nicht abgerufen. |
Render | Hierbei handelt es sich nicht um ein Ereignis. Stattdessen wird diese Methode in dieser Phase der Verarbeitung vom Page-Objekt für jedes Steuerelement aufgerufen. Alle ASP.NET-Webserversteuerelemente verfügen über eine Render-Methode, die das an den Browser gesendete Markup des Steuerelements ausgibt. Wenn Sie ein benutzerdefiniertes Steuerelement erstellen, überschreiben Sie diese Methode normalerweise, um das Markup des Steuerelements auszugeben. Wenn Ihr benutzerdefiniertes Steuerelement jedoch nur standardmäßige ASP.NET-Webserversteuerelemente und kein benutzerdefiniertes Markup enthält, muss die Render-Methode nicht überschrieben werden. Weitere Informationen finden Sie unter Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen. Bei einem Benutzersteuerelement (ASCX-Datei) wird das Rendering automatisch mit eingebunden. Daher ist ein explizites Rendern im Code des Steuerelements nicht erforderlich. |
Unload | Wird für jedes Steuerelement und dann für die Seite ausgelöst. Verwenden Sie dieses Ereignis für die abschließende Bereinigung bestimmter Steuerelemente, wie z. B. für das Schließen steuerelementspezifischer Datenbankverbindungen. Die Seite selbst kann mit diesem Ereignis ebenfalls abschließend bereinigt werden. Dabei werden offene Dateien und Datenbankverbindungen geschlossen und Anmeldevorgänge bzw. andere anforderungsspezifische Aufgaben abgeschlossen. Hinweis Die Seite und ihre Steuerelemente wurden während der Phase des Entladens gerendert. Daher können Sie keine weiteren Änderungen an dem Antwortstream vornehmen.Bei dem Versuch, eine Methode aufzurufen, z. B. die Response.Write-Methode, wird von der Seite eine Ausnahme ausgelöst. |
