CompilationMode Enumeration

  • Referenz

Definition

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

Definiert Konstanten, die angeben, wie ASP.NET ASPX-Seiten und ASCX-Steuerelemente kompilieren soll

public enum class CompilationMode
public enum CompilationMode
type CompilationMode = 
Public Enum CompilationMode
Vererbung
Object
ValueType
Enum
CompilationMode

Felder

Always 2

Die Seite sollte immer kompiliert werden.
Auto 0

ASP.NET wird die Seite nicht kompilieren, sofern dies möglich ist.
Never 1

Die Seite oder das Steuerelement sollte nie dynamisch kompiliert werden.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die CompilationMode Seitendirektive verwendet wird, um anzugeben, dass eine Seite nie kompiliert werden soll.

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

Hinweise

Die CompilationMode Enumerationswerte geben an, ob eine Seite oder ein Steuerelement zur Laufzeit kompiliert werden soll. Wenn kein Kompilierungsmodus angegeben wird, ist Alwaysder Standardwert . Wenn Sie eine Seite so festlegen, dass keine Kompilierung mithilfe des Attributs erfolgt, erhöht sich die Never Leistung, indem die angegebene Seite im Kompilierungsprozess disqualifiziert wird. Um ein seitenspezifisches CompilationMode Attribut zu definieren, das eine ASPX-, ASCX- oder MASTER-Datei angibt, die nicht auf Seitenebene kompiliert werden soll, können Sie eine Anweisung wie die folgende verwenden:

<%@ page compilationMode="never" %>

Der Kompilierungsmodus kann auch in Konfigurationsdateien angegeben werden. Das PagesSection Konfigurationsabschnittsobjekt identifiziert seitenspezifische Konfigurationseinstellungen. Das Pages-Konfigurationsabschnittselement kann auf den Computer-, Standort-, Anwendungs- und Unterverzeichnisebenen der Konfigurationsdateien deklariert werden.

Wenn auf CompilationMode festgelegt Never ist und eine Seite einen Skriptblock oder codekonstrukt enthält, das kompiliert werden muss, wird ASP.NET mit einem Fehler zurückgegeben, und die Seite wird nicht ausgeführt.

Gilt für:

Weitere Informationen