ASP.NET => Cycle de vie de la page

Événements du cycle de vie

Voici les événements du cycle de vie de la page:

PreInit - PreInit est le premier événement du cycle de vie d'une page. Il vérifie la propriété IsPostBack et détermine si la page est une publication. Il définit les thèmes et les pages maîtres, crée des contrôles dynamiques et obtient et définit les valeurs des propriétés du profil. Cet événement peut être géré en remplaçant la méthode OnPreInit ou en créant un gestionnaire Page_PreInit.

L' événement Init -Init initialise la propriété de contrôle et l'arborescence de contrôle est générée. Cet événement peut être géré en remplaçant la méthode OnInit ou en créant un gestionnaire Page_Init.

InitComplete - L'événement InitComplete permet le suivi de l'état de la vue. Toutes les commandes activent le suivi de l'état d'affichage.

LoadViewState - L'événement LoadViewState permet de charger les informations d'état d'affichage dans les contrôles.

LoadPostData - Au cours de cette phase, le contenu de tous les champs d'entrée est défini avec la balise.

PreLoad - PreLoad se produit avant que les données postérieures ne soient chargées dans les contrôles. Cet événement peut être géré en remplaçant la méthode OnPreLoad ou en créant un gestionnaire Page_PreLoad.

Load - L'événement Load est d'abord déclenché pour la page, puis récursivement pour tous les contrôles enfants. Les contrôles de l'arborescence de contrôle sont créés. Cet événement peut être géré en remplaçant la méthode OnLoad ou en créant un gestionnaire Page_Load.

LoadComplete - Le processus de chargement est terminé, les gestionnaires d'événements de contrôle sont exécutés et la validation de la page a lieu. Cet événement peut être géré en remplaçant la méthode OnLoadComplete ou en créant un gestionnaire Page_LoadComplete

PreRender - L'événement PreRender se produit juste avant le rendu de la sortie. En gérant cet événement, les pages et les contrôles peuvent effectuer toutes les mises à jour avant le rendu de la sortie.

PreRenderComplete - Lorsque l'événement PreRender est déclenché de manière récursive pour tous les contrôles enfants, cet événement garantit la fin de la phase de pré-rendu.

SaveStateComplete - L'état du contrôle sur la page est enregistré. Les informations de personnalisation, d'état de contrôle et d'état d'affichage sont enregistrées. Le balisage HTML est généré. Cette étape peut être gérée en remplaçant la méthode Render ou en créant un gestionnaire Page_Render.

UnLoad - La phase UnLoad est la dernière phase du cycle de vie de la page. Il déclenche l'événement UnLoad pour tous les contrôles de manière récursive et enfin pour la page elle-même. Le nettoyage final est terminé et toutes les ressources et références, telles que les connexions à la base de données, sont libérées. Cet événement peut être géré en remplaçant la méthode OnUnLoad ou en créant un gestionnaire Page_UnLoad.

Exemple de code

using System;

namespace myProject
{
    public partial class WebForm1 : System.Web.UI.Page
    {
        public string PageSteps = string.Empty;

        //Raised after the start stage is complete and before the initialization stage begins.
        protected void Page_PreInit(object sender, EventArgs e)
        {
            PageSteps += "1 - Page_PreInit<br>";

            //Access to page Controls not available in this step
            //Label1.Text = "Step 1";
        }

        //Raised after all controls have been initialized and any skin settings have been applied.
        //The Init event of individual controls occurs before the Init event of the page.
        protected void Page_Init(object sender, EventArgs e)
        {
            PageSteps += "2 - Page_Init<br>";

            Label1.Text = "Step 2";
        }

        //Raised at the end of the page's initialization stage.
        //Only one operation takes place between the Init and InitComplete events: tracking of view state changes is turned on.
        //View state tracking enables controls to persist any values that are programmatically added to the ViewState collection.
        //Until view state tracking is turned on, any values added to view state are lost across postbacks.
        //Controls typically turn on view state tracking immediately after they raise their Init event.
        protected void Page_InitComplete(object sender, EventArgs e)
        {
            PageSteps += "3 - Page_InitComplete<br>";

            Label1.Text = "Step 3";
        }

        //Raised after the page loads view state for itself and all controls, and after it processes postback data that is included with the Request instance.
        protected override void OnPreLoad(EventArgs e)
        {
            PageSteps += "4 - OnPreLoad<br>";

            Label1.Text = "Step 4";
        }

        //The Page object calls the OnLoad method on the Page object, and then recursively does the same for each child control until the page and all controls are loaded.
        //The Load event of individual controls occurs after the Load event of the page.
        protected void Page_Load(object sender, EventArgs e)
        {
            PageSteps += "5 - Page_Load<br>";

            Label1.Text = "Step 5";
        }

        //Use these events to handle specific control events, such as a Button control's Click event or a TextBox control's TextChanged event.
        protected void btnSubmit_Click(object sender, EventArgs e)
        {
            //Step only visible on PostBack
            PageSteps += "6 - btnSubmit_Click<br>";

            Label1.Text = "Step 6";
        }

        //Raised at the end of the event-handling stage.
        protected void Page_LoadComplete(object sender, EventArgs e)
        {
            PageSteps += "7 - Page_LoadComplete<br>";

            Label1.Text = "Step 7";
        }

        //Raised after the Page object has created all controls that are required in order to render the page, including child controls of composite controls.
        //(To do this, the Page object calls EnsureChildControls for each control and for the page.)
        protected override void OnPreRender(EventArgs e)
        {
            PageSteps += "8 - OnPreRender<br>";

            Label1.Text = "Step 8";
        }

        //Raised after each data bound control whose DataSourceID property is set calls its DataBind method.
        protected override void OnPreRenderComplete(EventArgs e)
        {
            PageSteps += "9 - OnPreRenderComplete<br>";

            Label1.Text = "Step 9";
        }


        //Raised after view state and control state have been saved for the page and for all controls.
        //Any changes to the page or controls at this point affect rendering, but the changes will not be retrieved on the next postback.
        protected override void OnSaveStateComplete(EventArgs e)
        {
            PageSteps += "10 - OnSaveStateComplete<br><hr><br>";

            Label1.Text = "Step 10";
        }

        // Render
        //This is not an event; instead, at this stage of processing, the Page object calls this method on each control.
        //All ASP.NET Web server controls have a Render method that writes out the control's markup to send to the browser.

        //Raised for each control and then for the page.
        //Controls use this event to do final cleanup for specific controls, such as closing control-specific database connections
        protected void Page_UnLoad(object sender, EventArgs e)
        {
            //This last PageSteps addition will not be visible on the page
            PageSteps += "11 - Page_UnLoad<br>";

            //Access to page Controls not available in this step
            //Label1.Text = "Step 11";      
        }
    }
}

Ajoutez le code suivant à la page .aspx pour visualiser les étapes du cycle de vie.

<b>Page Life Cycle Visualization:</b>
<br />
<%= PageSteps %>

Plus d'information

Modified text is an extract of the original Stack Overflow Documentation

Sous licence CC BY-SA 3.0

Non affilié à Stack Overflow

ASP.NET
Cycle de vie de la page

Recherche…

Événements du cycle de vie

Exemple de code