Control.OnInit Method
Raises the Init event.
[Visual Basic] Protected Overridable Sub OnInit( _ ByVal e As EventArgs _ ) [C#] protected virtual void OnInit( EventArgs e ); [C++] protected: virtual void OnInit( EventArgs* e ); [JScript] protected function OnInit( e : EventArgs );
Parameters
- e
- An EventArgs object that contains the event data.
Remarks
When notified by this method, 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 lifecycle, the control's view state has yet to be populated. Additionally, you can not access other server controls when this method is called either, regardless of whether it is a child or parent to this control. Other server controls are not certain to be created and ready for access.
Example
[Visual Basic] ' Override the OnInit method to write text to the ' containing page if the _text property is null. <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _ Protected Overrides Sub OnInit(e As EventArgs) MyBase.OnInit(e) If _text Is Nothing Then _text = "Here is some default text." End If End Sub 'OnInit [C#] // Override the OnInit method to write text to the // containing page if the _text property is null. [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] protected override void OnInit(EventArgs e) { base.OnInit(e); if ( _text == null) _text = "Here is some default text."; } [C++] // Override the OnInit method to write text to the // containing page if the _text property is 0. protected: [System::Security::Permissions::PermissionSet(System::Security::Permissions::SecurityAction::Demand, Name="FullTrust")] void OnInit(EventArgs* e) { __super::OnInit(e); if (_text == 0) _text = S"Here is some default text."; }
[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
Control Class | Control Members | System.Web.UI Namespace | Page | Control Execution Lifecycle