This documentation is archived and is not being maintained.

Form.Activate Event

Occurs when a form becomes active. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site.

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

public event EventHandler Activate
<asp:Form OnActivate="EventHandler" />

The Activate event occurs under the following circumstances:

  • When a page is first requested, the first form is activated.

  • When the ActiveForm property of the page is set programmatically.

  • When the user navigates to a form through a Link control whose target is a form.

This event's position in the event chain makes it very important for binding child controls to data sources or for setting a form property that can be inherited by all child controls.

The following code example shows how to set the OnActivate attribute in the Form element to point to a method that executes when the Activate event occurs. The Form2_Activate method prepares the second form for display. This example is part of a larger example for the Form overview.

NoteNote

The following code example uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code example must be copied into an empty text file that has an .aspx extension. For more information, see ASP.NET Web Page Syntax Overview.


// When Form2 is activated
private void Form2_Activate(object sender, EventArgs e)
{
    Form2.BackColor = Color.DarkGray;
    Form2.ForeColor = Color.White;
    Form2.Font.Bold = BooleanOption.True;
}


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: