Events in ASP.NET Master and Content Pages

Both master pages and content pages can contain event handlers for controls. For controls, events are handled locally—a control in a content page raises an event in the content page, and a control in the master page raises an event in the master page. Controls events are not sent from the content page to the master page. Similarly, you cannot handle an event from a master page control in a content page.

In some cases, the same event is raised in both the content and the master page. For example, both pages raise Init and Load events. The general rule for how events are raised is that the initialization events are raised from the innermost control to the outermost one, and all other events are raised from the outermost control to the innermost one. It is helpful to remember that the master page is merged into the content page and treated as a control in the content page.

The following is the sequence in which events occur when a master page is merged with a content page:

  1. Content page PreInit event.

  2. Master page controls Init event.

  3. Content controls Init event.

  4. Master page Init event.

  5. Content page Init event.

  6. Content page Load event.

  7. Master page Load event.

  8. Master page controls Load event.

  9. Content page controls Load event.

  10. Content page PreRender event.

  11. Master page PreRender event.

  12. Master page controls PreRender event.

  13. Content page controls PreRender event.

  14. Master page controls Unload event.

  15. Content page controls Unload event.

  16. Master page Unload event.

  17. Content page Unload event.

The sequence of events in master and content pages rarely is important for you as page developer. However, if you are creating event handlers that depend on the availability of certain controls, you will find it helpful to understand the event sequence in master and content pages.

See Also

Tasks

How to: Reference ASP.NET Master Page Content

Other Resources

ASP.NET Master Pages