Export (0) Print
Expand All
2 out of 2 rated this helpful - Rate this topic

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 Language Filter 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

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.