CompilationMode Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define constantes que especificam como ASP.NET deve compilar .aspx páginas e controles .ascx.
public enum class CompilationMode
public enum CompilationMode
type CompilationMode =
Public Enum CompilationMode
- Herança
Campos
| Nome | Valor | Description |
|---|---|---|
| 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. |
| Always | 2 | A página sempre deve ser compilada. |
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 uma .aspx, .ascx ou arquivo .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 o CompilationMode estiver definido como Never e uma página contiver um bloco de script ou construção de código que exija compilação, ASP.NET retornará com um erro e a página não será executada.