Control.OnUnload-Methode
Löst das Unload-Ereignis aus.
Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Protected Friend Overridable Sub OnUnload ( _
e As EventArgs _
)
'Usage
Dim e As EventArgs
Me.OnUnload(e)
protected internal virtual void OnUnload (
EventArgs e
)
protected public:
virtual void OnUnload (
EventArgs^ e
)
protected void OnUnload (
EventArgs e
)
protected internal function OnUnload (
e : EventArgs
)
Parameter
- e
Ein EventArgs-Objekt, das Ereignisdaten enthält.
Hinweise
Serversteuerelemente müssen in dieser Phase des Lebenszyklus des Steuerelements alle Bereinigungen durchführen, wie das Schließen von Dateien und Datenbankverbindungen sowie das Verwerfen von Objekten.
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. Beim Aufruf der OnUnload-Methode wird die Zeichenfolge "Custom control was unloaded" 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
Unload