Freigeben über


Control.OnLoad-Methode

Löst das Load-Ereignis aus.

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

Syntax

'Declaration
Protected Friend Overridable Sub OnLoad ( _
    e As EventArgs _
)
'Usage
Dim e As EventArgs

Me.OnLoad(e)
protected internal virtual void OnLoad (
    EventArgs e
)
protected public:
virtual void OnLoad (
    EventArgs^ e
)
protected void OnLoad (
    EventArgs e
)
protected internal function OnLoad (
    e : EventArgs
)

Parameter

  • e
    Das EventArgs-Objekt, das die Ereignisdaten enthält.

Hinweise

Diese Methode weist das Serversteuerelement an, die Aktionen auszuführen, die für jede HTTP-Anforderung der zugeordneten Seite üblich sind, z. B. Einrichten einer Datenbankabfrage. Auf dieser Stufe im Lebenszyklus der Seite werden Serversteuerelemente in der Hierarchie erstellt und initialisiert, der Ansichtszustand wird wiederhergestellt und Formularsteuerelemente spiegeln die Clientdaten wider.

Bestimmen Sie mithilfe der IsPostBack-Eigenschaft, ob die Seite als Antwort auf ein Postback des Clients geladen wird oder ob das Laden und Zugreifen zum ersten Mal erfolgt.

Beispiel

Im folgenden Beispiel wird das Textstreamobjekt myFile erstellt. Mit diesem werden dann Meldungen an eine Textdatei ausgegeben, wenn während der Verarbeitung von Anforderungen definierte Ereignisse im Lebenszyklus von Page und von Steuerelementen eintreten. Während des Aufrufs der OnLoad-Methode wird die Zeichenfolge "Custom control has loaded" in die Datei geschrieben und das Textstreamobjekt geschlossen.

' Create a StreamWriter to write data to a text file.
 Dim myFile As TextWriter = File.CreateText("c:\NewTextFile.txt")

Sub Page_Load(sender As Object, e As EventArgs)
   ' Write status to file.
   myFile.WriteLine("Page has loaded.")
End Sub

Sub CustomControl_OnLoad(sender As Object, e As EventArgs)
   myFile.WriteLine("Custom control has loaded.")
End Sub

Sub CustomControl_OnUnload(sender As Object, e As EventArgs)
   ' Server controls final cleanup such as;
   ' closing files etc.goes here         
   myFile.WriteLine("Custom control was unloaded.")
   ' Close the stream object.
   myFile.Close()
End Sub
// Create a StreamWriter to write data to a text file.
TextWriter myFile = File.CreateText("c:\\NewTextFile.txt");

void Page_Load(object sender,EventArgs e)
{
   // Write status to file.
   myFile.WriteLine("Page has loaded.");
}
void CustomControl_OnLoad(object sender,EventArgs e)
{
   myFile.WriteLine("Custom control has loaded.");
}

void CustomControl_OnUnload(object sender,EventArgs e)
{
   // Server controls final cleanup such as; 
   // closing files goes here         
   myFile.WriteLine("Custom control was unloaded.");
  // Close the stream object.
   myFile.Close();
}
// Create a StreamWriter to write data to a text file.
TextWriter myFile = File.CreateText("c:\\NewTextFile.txt");

void Page_Load(Object sender,EventArgs e)
{
    // Write status to file.
    myFile.WriteLine("Page has loaded.");
} //Page_Load

void CustomControl_OnLoad(Object sender,EventArgs e)
{
    myFile.WriteLine("Custom control has loaded.");
} //CustomControl_OnLoad

void CustomControl_OnUnload(Object sender,EventArgs e)
{
    // Server controls final cleanup such as; 
    // closing files goes here         
    myFile.WriteLine("Custom control was unloaded.");
    // Close the stream object.
    myFile.Close();
} //CustomControl_OnUnload

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

Control-Klasse
Control-Member
System.Web.UI-Namespace
Page
IsPostBack

Weitere Ressourcen

Übersicht über den Lebenszyklus von ASP.NET-Seiten