Control.Init Event

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

Public Event Init As EventHandler

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.

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

<%@ 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>

.NET Framework
Available since 1.1
Return to top
Show: