Page.OnInit(EventArgs) Method

Definition

Raises the Init event to initialize the page.

protected public:
 override void OnInit(EventArgs ^ e);
protected internal override void OnInit (EventArgs e);
override this.OnInit : EventArgs -> unit
Protected Friend Overrides Sub OnInit (e As EventArgs)

Parameters

e
EventArgs

An EventArgs that contains the event data.

Remarks

The OnInit method performs the initialization and setup steps required to create a Page instance. In this stage of the page's life cycle, declared server controls on the page are initialized to their default state; however, the view state of each control is not yet populated. A control on the page cannot access other server controls on the page during the Page_Init phase, regardless of whether the other controls are child or parent controls. Other server controls are not guaranteed to be created and ready for access.

The OnInit method is called after the OnPreInit method and before the OnInitComplete method.

Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.

The OnInit method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors

When overriding OnInit(EventArgs) in a derived class, be sure to call the base class's OnInit(EventArgs) method so that registered delegates receive the event.

Applies to