Custom Search Tailored for Microsoft .NET  
Aspexception.com Skip Navigation Links
Error RepositoryExpand Error Repository
.NET ResourcesExpand .NET Resources
About
Skip Navigation LinksHome > .NET Resources > ASP.NET Basics > ASP.NET Page Events
ASP.NET Page Events
The Page object serves as the naming container for all server controls in a page. The Page class is a control that acts as the user interface for Web applications. As you can see from the inheritance hierarchy, Control class is the base class of the Page class.
System.Object 
   System.Web.UI.Control 
     System.Web.UI.TemplateControl 
      System.Web.UI.Page
Due to this inheritance, the Page objects inherited all events from Control class.
Page Event Typical Use Event Handler
PreInit Occurs at the beginning of page initialization. OnPreInit
Init

Raised after all controls have been initialized and any skin settings have been applied. Use this event to read or initialize control properties.

In a page with Master page and server controls, the Init events happened in the following sequences:

Init in server controls
    Init in Master page
       Init in the page
OnInit
InitComplete Occurs when page initialization is complete. Use this event for processing tasks that require all initialization be complete. OnInitComplete
PreLoad

Use this event if you need to perform processing on your page or control before the Load event.

After the Page raises this event, it loads view state for itself and all controls, and then processes any postback data included with the Request instance.

OnPreLoad
Load

The Page calls the OnLoad event method on the Page, then recursively does the same for each child control, which does the same for each of its child controls until the page and all controls are loaded.

Use the OnLoad event method to set properties in controls and establish database connections.

In a page with Master page and server controls, the Load events happened in the following sequences:

Load in the page object
    Load in Master page
       Load in the server controls
OnLoad

Control events

Use these events to handle specific control events, such as a Button control's Click event or a TextBox control's TextChanged event.

LoadComplete

Use this event for tasks that require that all other controls on the page be loaded.

OnLoadComplete
PreRender

Before this event occurs:

  • The Page object calls for each control and for the page.

  • Each data bound control whose DataSourceID property is set calls its DataBind method. .

The PreRender event occurs for each control on the page. Use the event to make final changes to the contents of the page or its controls.

OnPreRender
SaveStateComplete

Before this event occurs, ViewState has been saved for the page and for all controls. Any changes to the page or controls at this point will be ignored.

Use this event perform tasks that require view state to be saved, but that do not make any changes to controls.

OnSaveStateComplete
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 that is sent to the browser.

If you create a custom control, you typically override this method to output the control's markup. However, if your custom control incorporates only standard ASP.NET Web server controls and no custom markup, you do not need to override the Render method.

A user control (an .ascx file) automatically incorporates rendering, so you do not need to explicitly render the control in code.

 
Unload

This event occurs for each control and then for the page. In controls, use this event to do final cleanup for specific controls, such as closing control-specific database connections.

For the page itself, use this event to do final cleanup work, such as closing open files and database connections, or finishing up logging or other request-specific tasks.

Note

During the unload stage, the page and its controls have been rendered, so you cannot make further changes to the response stream. If you attempt to call a method such as the Response.Write method, the page will throw an exception.

In a page with Master page and server controls, the Unload events happened in the following sequences:

Unload in server controls
    Unload in Master page
       Unload in the page
 
Site Map  Copyright © Aspexception.com 2008. All rights Reserved. Terms of Use