HtmlForm.OnInit(EventArgs) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
protected:
override void OnInit(EventArgs ^ e);protected public:
override void OnInit(EventArgs ^ e);protected override void OnInit (EventArgs e);protected internal override void OnInit (EventArgs e);override this.OnInit : EventArgs -> unitProtected Overrides Sub OnInit (e As EventArgs)Protected Friend Overrides Sub OnInit (e As EventArgs)Parameters
Remarks
When notified by the OnInit method, Web server controls must perform any initialization steps that are required to create and set up an instance. In this stage of the server control's life cycle, the control's view state has yet to be populated. Additionally, you cannot access other server controls when this method is called, regardless of whether it is a child or parent to this control. Other server controls are not guaranteed to be created and ready for access.
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.
The OnInit method is used primarily by control developers extending the functionality of the HtmlForm control.
Notes to Inheritors
When overriding the OnInit(EventArgs) method in a derived class, be sure to call the base class's OnInit(EventArgs) method so that registered delegates receive the event. Additionally, calling the base class's OnInit(EventArgs) method ensures that the HtmlForm control is properly set as the Web page form and the page's view state is persisted.
