CompilationMode Перечисление

Определение

Определяет константы, указывающие каким образом ASP.NET должен компилировать страницы .aspx и элементы управления .ascx.Defines constants that specify how ASP.NET should compile .aspx pages and .ascx controls.

public enum class CompilationMode
public enum CompilationMode
type CompilationMode = 
Public Enum CompilationMode
Наследование
CompilationMode

Поля

Always 2

Страница должна компилироваться в любом случае.The page should always be compiled.

Auto 0

ASP.NET не будет компилировать страницу, если это возможно.ASP.NET will not compile the page, if possible.

Never 1

Станица или элемент управления не должны компилироваться динамически.The page or control should never be dynamically compiled.

Примеры

В следующем примере показано, как использовать CompilationMode директиву Page, чтобы указать, что страница не должна компилироваться.The following example demonstrates how to use the CompilationMode page directive to indicate that a page should never be compiled.

<%@ Page Language="C#" compilationMode="never" %>
<%@ Import namespace="System.IO" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>CompilationMode Example</title>
</head>
<body>
<form id="Form1" runat="server">

Script blocks are not allowed on this page. 
Any server side code that requires compilation 
contained in this page would cause the page to fail
</form>
</body>
</html>
<%@ Page Language="VB" compilationMode="never" %>
<%@ Import namespace="System.IO" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>CompilationMode Example</title>
</head>
<body>
<form id="Form1" runat="server">
Script blocks are not allowed on this page. 
Any server side code that requires compilation 
contained in this page would cause the page to fail
</form>
</body>
</html>

Комментарии

Значения CompilationMode перечисления указывают, следует ли компилировать страницу или элемент управления во время выполнения.The CompilationMode enumeration values indicate whether a page or control should be compiled at run time. Если режим компиляции не указан, по умолчанию используется Alwaysзначение.When no compilation mode is specified, the default value is Always. Если задать для страницы значение "никогда не Never компилировать с помощью атрибута", производительность повышается за счет уточнения указанной страницы в процессе компиляции.Setting a page to never compile using the Never attribute increases performance by disqualifying the specified page in the compilation process. Чтобы определить атрибут для конкретной CompilationMode страницы, указывающий, что файл. aspx,. ascx или. master не следует компилировать на уровне страницы, можно использовать директиву, подобную следующей:To define a page-specific 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. Объект PagesSection раздела конфигурации определяет параметры конфигурации, относящиеся к странице.The PagesSection configuration section object identifies page-specific configuration settings. Элемент раздела конфигурации pages может быть объявлен на уровне компьютера, сайта, приложения и подкаталога файлов конфигурации.The pages configuration section element can be declared at the machine, site, application, and subdirectory levels of the configuration files.

Если параметр Never имеет значение и страница содержит блок скрипта или конструкцию кода, для которой требуется компиляция, ASP.NET возвращает ошибку, а страница не выполняется. CompilationModeIf the CompilationMode is set to Never and a page contains a script block or code construct that requires compilation, ASP.NET returns with an error and the page doesn't run.

Применяется к

Дополнительно