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

Control.OnLoad, méthode

Déclenche l'événement Load.

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

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

Paramètres

e

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

Cette méthode avertit le contrôle serveur qu'il doit effectuer des actions communes à toutes les demandes HTTP de la page à laquelle il est associé, par exemple la configuration d'une requête de base de données. À cette étape du cycle de vie de la page, des contrôles serveur sont créés et initialisés dans la hiérarchie, l'état d'affichage est restauré et les contrôles de formulaire reflètent les données côté client.

Utilisez la propriété IsPostBack pour déterminer si la page est en cours de chargement soit en réponse à une publication du client, soit en réponse à une première demande d'accès.

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 OnLoad, la chaîne "Custom control has loaded" (Le contrôle personnalisé a été 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: