Cette documentation est archivée et n’est pas conservée.

Control.OnUnload, méthode

Déclenche l'événement Unload.

Espace de noms : System.Web.UI
Assembly : System.Web (dans system.web.dll)

protected internal virtual void OnUnload (
	EventArgs e
)
protected void OnUnload (
	EventArgs e
)
protected internal function OnUnload (
	e : EventArgs
)

Paramètres

e

Objet EventArgs qui contient les données d'événement.

Les contrôles serveur doivent effectuer le nettoyage final éventuel (fermeture de fichiers, fermeture des connexions aux bases de données et suppression d'objets) pendant cette étape du cycle de vie du contrôle serveur.

L'exemple suivant crée un objet flux de texte, myFile et l'utilise pour imprimer des messages dans un fichier texte lorsque des événements de cycle de vie du contrôle et Page définis se produisent au cours du traitement de la demande. Pendant l'appel à la méthode OnUnload, la chaîne "Custom control was unloaded" (Le contrôle personnalisé a été déchargé) est écrite dans le fichier et l'objet flux de texte est fermé.

// 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

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: