CompilationMode 列挙体

.NET Framework クラス ライブラリ リファレンス

CompilationMode 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

ASP.NET が .aspx ページと .ascx コントロールをコンパイルする方法を指定する定数を定義します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Enumeration CompilationMode

Visual Basic (使用法)

Dim instance As CompilationMode

C#

public enum CompilationMode

C++

public enum class CompilationMode

J#

public enum CompilationMode

JScript

public enum CompilationMode

メンバ

	メンバ名	説明
	Always	ページが常にコンパイルされます。
	Auto	ASP.NET は、可能な場合でもページをコンパイルしません。
	Never	ページまたはコントロールは動的にコンパイルされません。

解説

CompilationMode 列挙値は、ページまたはコントロールを実行時にコンパイルする必要があるかどうかを示します。コンパイル モードを指定しない場合、既定値は Always です。Never 属性を使用して、コンパイルしないようにページを設定すると、指定したページがコンパイル処理から除外され、パフォーマンスが向上します。.aspx、.ascx または .master の各ファイルがコンパイルされないようにページ レベルで指定する、ページ固有の CompilationMode 属性を定義するには、次のようなディレクティブを使用します。

<%@ page compilationMode=”never” %>

コンパイル モードは、構成ファイルで指定することもできます。ページ固有の構成設定は、PagesSection 構成セクション オブジェクトで指定します。pages 構成セクション要素は、構成ファイルの、コンピュータ、サイト、アプリケーション、およびサブディレクトリの各レベルで宣言できます。

CompilationMode が Never に設定されている場合に、スクリプト ブロックや、コンパイルを必要とするコード コンストラクタがページに含まれていると、ASP.NET はエラーを返し、ページは実行されません。

使用例

CompilationMode ページ ディレクティブを使用して、ページをコンパイルしないように指定する方法を次のコード例に示します。

Visual Basic

<%@ Page Language="VB" compilationMode="never"
 %>
<%@ Import namespace="System.IO"
 %>

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

C#

<%@ Page Language="C#" compilationMode="never" %>
<%@ Import namespace="System.IO" %>

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.Web.UI 名前空間
PagesSection
CompilationMode