Control.Init Event

Definition

Occurs when the server control is initialized, which is the first step in its lifecycle.

public:
 event EventHandler ^ Init;
public event EventHandler Init;
member this.Init : EventHandler 
Public Custom Event Init As EventHandler 

Event Type

Examples

The following example assigns a custom event handler, Calendar_Init, to the Init event of a Calendar control.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Calendar_Init(object sender, EventArgs e)
  {
    // Do any related intialization work.
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Control Init Event Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
       <asp:Calendar ID="Calendar1"
                     runat="server" 
                     OnInit="Calendar_Init"/>
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Calendar_Init(ByVal sender As Object, ByVal e As System.EventArgs)

    ' Do any related intialization work.
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Control Init Event Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
       <asp:Calendar ID="Calendar1"
                     runat="server" 
                     OnInit="Calendar_Init"/>
    </div>
    </form>
</body>
</html>

Remarks

Server controls should perform any initialization steps that are required to create and set up an instance. You cannot use view-state information within this event; it is not populated yet. You should not access another server control during this event, 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. For more information on server control events, see ASP.NET Web Forms Server Control Event Model.

Applies to

See also