HtmlForm.OnInit-Methode

Löst das Init-Ereignis für das HtmlForm-Steuerelement aus.

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Friend Overrides Sub OnInit ( _
    e As EventArgs _
)
'Usage
Dim e As EventArgs

Me.OnInit(e)

protected internal override void OnInit (
    EventArgs e
)

protected public:
virtual void OnInit (
    EventArgs^ e
) override

protected void OnInit (
    EventArgs e
)

protected internal override function OnInit (
    e : EventArgs
)

Parameter

• e
  Ein EventArgs, das Ereignisdaten enthält.

Hinweise

Webserversteuerelemente müssen bei Benachrichtigung durch die OnInit-Methode sämtliche Initialisierungsschritte ausführen, die für das Erstellen und Einrichten einer Instanz erforderlich sind. Auf dieser Stufe im Lebenszyklus eines Serversteuerelements muss der Ansichtszustand des Steuerelements noch aufgefüllt werden. Außerdem können Sie beim Aufruf dieser Methode auf kein anderes Serversteuerelement zugreifen, unabhängig davon, ob es sich um ein untergeordnetes oder ein übergeordnetes Steuerelement handelt. Es ist nicht gewährleistet, dass andere Serversteuerelemente erstellt werden und zugriffsbereit sind.

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

Die OnInit-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.

Die OnInit-Methode wird hauptsächlich von Entwicklern von Steuerelementen zum Erweitern der Funktionalität des HtmlForm-Steuerelements verwendet.

Hinweise für Erben Wenn Sie die OnInit-Methode in einer abgeleiteten Klasse überschreiben, müssen Sie unbedingt die OnInit-Methode der Basisklasse aufrufen, sodass registrierte Delegaten das Ereignis empfangen. Außerdem stellt das Aufrufen der OnInit-Methode der Basisklasse sicher, dass das HtmlForm-Steuerelement korrekt als Webseitenformular festgelegt und der Ansichtszustand der Seite beibehalten wird.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HtmlForm-Klasse
HtmlForm-Member
System.Web.UI.HtmlControls-Namespace
RegisterViewStateHandler

Weitere Ressourcen

HTML-Serversteuerelemente