PagesSection.AutoEventWireup Property

Gets or sets a value indicating whether events for ASP.NET pages are automatically connected to event-handling functions.

Namespace: System.Web.Configuration
Assembly: System.Web (in system.web.dll)

public bool AutoEventWireup { get; set; }
/** @property */
public boolean get_AutoEventWireup ()

/** @property */
public void set_AutoEventWireup (boolean value)

public function get AutoEventWireup () : boolean

public function set AutoEventWireup (value : boolean)

Not applicable.

Property Value

true if events for ASP.NET pages are automatically connected to event-handling functions; otherwise, false. The default is true.

When AutoEventWireup is true, ASP.NET does not require events to specify event handlers like Page_Load or Page_Init. This means that the Handles keyword in Visual Basic is not required in the server script in the Web Form page.

By default, when the ASP.NET Web application is created in Visual Studio, the value of the AutoEventWireup attribute is set to false in the .aspx page or .ascx control, and event handlers are not automatically created. Do not set AutoEventWireup to true if performance is a key consideration.

The following code example shows how to use the AutoEventWireup property.

// Get the current AutoEventWireup property value.
    "Current AutoEventWireup value: '{0}'",

// Set the AutoEventWireup property to false.
pagesSection.AutoEventWireup = false;

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0