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 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
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.