System.Web.UI.CompilationMode Enumeration

Defines constants that specify how ASP.NET should compile .aspx pages and .ascx controls.

Syntax

public enum CompilationMode

Remarks

The System.Web.UI.CompilationMode enumeration values indicate whether a page or control should be compiled at run time. When no compilation mode is specified, the default value is CompilationMode.Always. Setting a page to never compile using the CompilationMode.Never attribute will increase performance by disqualifying the specified page in the compilation process. To define a page-specific System.Web.UI.CompilationMode attribute that specifies an .aspx, .ascx or .master file should not be compiled at the page level, you can use a directive like the following:

<%@ page compilationMode="never" %>

The compilation mode can also be specified in configuration files. The System.Web.Configuration.PagesSection configuration section object identifies page-specific configuration settings. The pages configuration section element can be declared at the machine, site, application, and subdirectory levels of the configuration files.

If the System.Web.UI.CompilationMode is set to CompilationMode.Never and a page contains a script block or code construct that requires compilation, ASP.NET will return with an error and the page will not run.

Members

Member NameDescription
Always

The page should always be compiled.

Auto

ASP.NET will not compile the page, if possible.

Never

The page or control should never be dynamically compiled.

Requirements

Namespace: System.Web.UI
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0