CompilationMode Enumeração

Definição

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
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 CompilationMode diretiva page 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 PagesSection objeto da seção de configuração identifica as definições de configuração 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 o CompilationMode estiver definido Never como e uma página contiver um bloco de script ou um constructo 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