CompilationMode Enumeração

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Define constantes que especificam como o ASP.NET deve compilar páginas .aspx e controles .ascx.

public enum class CompilationMode
public enum CompilationMode
type CompilationMode = 
Public Enum CompilationMode
Herança
Object
ValueType
Enum
CompilationMode

Campos

Always 2

A página sempre deve ser compilada.
Auto 0

ASP.NET não compilará a página, se possível.
Never 1

A página ou o controle nunca deve ser compilado dinamicamente.

Exemplos

O exemplo a seguir demonstra como usar a diretiva de CompilationMode página para indicar que uma página nunca deve ser compilada.

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

Comentários

Os CompilationMode valores de enumeração indicam se uma página ou controle deve ser compilado em tempo de execução. Quando nenhum modo de compilação é especificado, o valor padrão é Always. Definir uma página para nunca compilar usando o atributo aumenta o Never desempenho desqualificando a página especificada no processo de compilação. Para definir um atributo específico CompilationMode de página que especifica um arquivo .aspx, .ascx ou .master não deve ser compilado no nível da página, você pode usar uma diretiva como a seguinte:

<%@ page compilationMode="never" %>

O modo de compilação também pode ser especificado em arquivos de configuração. O objeto da PagesSection seção de configuração identifica as configurações específicas da página. O elemento da seção de configuração de páginas pode ser declarado nos níveis de computador, site, aplicativo e subdiretório dos arquivos de configuração.

Se a CompilationMode página estiver definida Never como e uma página contiver um bloco de script ou um build de código que exija compilação, ASP.NET retornará com um erro e a página não será executada.

Aplica-se a

Confira também