次の方法で共有

pages 要素 (ASP.NET 設定スキーマ)

  • [アーティクル]

更新 : 2007 年 11 月

構成ファイルのスコープ内にあるページおよびコントロールについて、ASP.NET ディレクティブなどのページ固有の構成設定をグローバル定義します。

configuration 要素 (全般設定スキーマ)
  system.web 要素 (ASP.NET 設定スキーマ)
    pages 要素 (ASP.NET 設定スキーマ)

<pages     
   buffer="[True|False]"
   enableEventValidation="[True|False]"
   enableSessionState="[True|False|ReadOnly]"
   enableViewState="[True|False]"
   enableViewStateMac="[True|False]"
   smartNavigation="[True|False]"
   autoEventWireup="[True|False]"
   pageBaseType="typename, assembly"
   userControlBaseType="typename"
   validateRequest="[True|False]"
   masterPageFile="file path" 
   theme="string"
   styleSheetTheme="string"
   maxPageStateFieldLength="number" 
   compilationMode="[Always|Auto|Never]" 
   pageParserFilterType="string" 
   viewStateEncryptionMode="[Always|Auto|Never]" 
   maintainScrollPositionOnPostBack="[True|False]" 
   asyncTimeout="number"
>
   <controls>...</controls>
   <namespaces>...</namespaces>
   <tagMapping>...</tagMapping>
</pages>

属性と要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性

説明

asyncTimeout

省略可能な TimeSpan 属性です。

非同期処理時に非同期ハンドラの完了を待機する時間を秒単位で指定します。

この属性は .NET Framework Version 2.0 で新たに追加されました。

既定値は "0:00:45" (45 秒) です。

autoEventWireup

省略可能な Boolean 型の属性です。

ページ イベントを自動的に有効にするかどうかを指定します。これは、自動イベント ワイヤアップが発生するかどうか、つまりシステムが特定のシグネチャ (page_Load など) を持つメソッドを自動的にアタッチするかどうかという意味です。詳細については、「ASP.NET Web サーバー コントロールのイベント モデル」を参照してください。

既定値は True です。

buffer

省略可能な Boolean 型の属性です。

URL リソースが応答バッファを使用するかどうかを指定します。

既定値は True です。

compilationMode

省略可能な CompilationMode 属性です。

ASP.NET のページまたはコントロールを実行時にコンパイルするかどうかを指定します。

compilationMode 属性は .NET Framework 2.0 で新たに追加されました。この属性には、次のいずれかの値を指定できます。既定値は Always です。

値説明
Always ページを常にコンパイルします。
Auto 可能な場合は、ページをコンパイルしません。
Never ページまたはコントロールを動的にコンパイルしません。 ASP.NET では、コンパイルを必要とするスクリプト ブロックまたはコード コンストラクタがページ内に含まれる場合にはエラーが返され、ページは実行されません。

enableEventValidation

ページとコントロールがポストバック イベントとコールバック イベントを検証するかどうかを指定します。既定値は True です。

enableSessionState

省略可能な String 属性です。

構成ファイルのスコープ内にあるリソースに対するセッション状態要件を指定します。

enableSessionState 属性は次のいずれかの値になります。既定値は True です。

値説明
False セッション状態が無効であることを示します。
ReadOnly セッション状態が書き込み可能ではないことを示します。
True セッション状態が有効であることを示します。

enableViewState

省略可能な Boolean 属性です。

ビューステートが有効になり、ページ要求間で維持されているかどうかを指定します。

既定値は True です。

enableViewStateMac

省略可能な Boolean 型の属性です。

クライアントからページがポストバックされたときに、ASP.NET がそのページのビューステートで MAC (Message Authentication Code) を実行するかどうかを指定します。True の場合は、暗号化されたビューステートが、クライアントで改ざんされていないかどうかを検証するために確認されます。

既定値は True です。

maintainScrollPositionOnPostBack

省略可能な Boolean 属性です。

ページがサーバーにポストバックされるときに、クライアント ブラウザの同じ位置にユーザーを返すかどうかを指定します。False の場合、ユーザーはポストバック時にページの一番上に返されます。

この属性は .NET Framework 2.0 で新たに追加されました。

既定値は False です。

masterPageFile

省略可能な String 属性です。

ローカル構成ファイルに対するマスタ ページの相対パスを指定します。masterPageFile 属性が True に設定されたページには、Content コントロールが最上位のコントロールとして含まれる必要があります。

この属性は .NET Framework 2.0 で新たに追加されました。

既定値は、空の文字列 ("") です。

maxPageStateFieldLength

省略可能な Int32 属性です。

ページの状態フィールドに入力できる文字列長の上限を指定します。正数に設定されている場合、クライアント ブラウザに送信されるビューステート フィールドはチャンクに分割され、各チャンクは maxPageStateFieldLength 属性に指定されたサイズよりも小さくなります。負数に設定すると、ビューステート フィールドはチャンクに分割されません。

この属性は .NET Framework 2.0 で新たに追加されました。

既定値は "-1" です。

pageBaseType

省略可能な String 型の属性です。

ページがスタンドアロン専用の場合に使用する基本型を指定します。これは、スタンドアロン ファイルの inherits 属性によってオーバーライドされます。

既定値は "System.Web.UI.Page" です。

pageParserFilterType

省略可能な String 型の属性です。

ページ内で項目が許可されているかどうかを解析時に確認するために ASP.NET パーサーが使用するフィルタの種類の名前を指定します。フィルタは、PageParserFilter クラスから派生する必要があります。

この属性は .NET Framework 2.0 で新たに追加されました。

既定値は、空の文字列 ("") です。

smartNavigation

省略可能な Boolean 型の属性です。

スマート ナビゲーションが有効かどうかを指定します。スマート ナビゲーションには、Microsoft Internet Explorer のバージョン 5.5 以降が必要です。スマート ナビゲーションを有効にすると、次の利点があります。

  • ナビゲーションの点滅がなくなる。

  • スクロール位置がページ間で保持される。

  • 要素のフォーカスがページ間で保持される。

  • ページの最終状態だけがブラウザの履歴に保持される。

この属性は .NET Framework 2.0 で新たに追加されましたが、使用を推奨していません。maintainScrollPositionOnPostBack 属性を優先して使用してください。

既定値は False です。

styleSheetTheme

省略可能な String 型の属性です。

テーマに適用するために使用される "テーマ" フォルダの名前をコントロールの宣言の前に指定します。一方、テーマ属性は、適用するテーマを、コントロールの宣言の後で定義します。

この属性は .NET Framework 2.0 で新たに追加されました。

既定値は、空の文字列 ("") です。

theme

省略可能な String 型の属性です。

構成ファイルのスコープ内にあるページに使用するテーマの名前を指定します。指定したテーマは、アプリケーションまたはグローバル テーマとして存在する必要があります。テーマが存在しない場合、HttpException 例外がスローされます。

この属性は .NET Framework 2.0 で新たに追加されました。

既定値は、空の文字列 ("") です。

userControlBaseType

省略可能な String 型の属性です。

ページがスタンドアロン専用の場合に使用する基本型を指定します。

既定値は "System.Web.UI.UserControl" です。

validateRequest

省略可能な Boolean 型の属性です。

ブラウザからのすべての入力データから危険性のあるデータを調べるように指定します。True の場合は、すべての入力データを危険性のある値のリストと比較することによって、検証を実行することを要求します。一致した場合は、HttpRequestValidationException 例外が発生します。

既定値は True です。

viewStateEncryptionMode

省略可能な ViewStateEncryptionMode 属性です。

ビューステートの暗号化モードを指定します。ViewStateEncryptionMode プロパティは、構成ファイル内に設定されたこの属性をオーバーライドします。

この属性には、次のいずれかの値を指定できます。

値説明
Always ビューステートを常に暗号化します。
Auto コントロールが要求した場合に、ビューステートを暗号化します。
Never コントロールが要求した場合でも、ビューステートを暗号化しません。

この属性は .NET Framework 2.0 で新たに追加されました。

既定値は Auto です。

子要素

要素

説明

controls

レジスタ ディレクティブのコレクションおよびタグ プレフィックスが存在する名前空間を定義します。

namespaces

アセンブリのプリコンパイル時に使用するインポート ディレクティブのコレクションを定義します。

tagMapping

コンパイル時に他のタグの種類にリマップされるタグの種類のコレクションを定義します。

親要素

要素

説明

configuration

共通言語ランタイムおよび .NET Framework ベースのアプリケーションで使用されるすべての構成ファイルで必要なルート要素です。

system.web

構成ファイルの ASP.NET 構成設定のルート要素を指定します。ASP.NET Web アプリケーションを構成する構成要素やアプリケーションの動作を制御する構成要素が含まれます。

解説

pages 要素は、ページ固有の構成設定を定義します。この構成セクションでは、構成ファイルのスコープ内にあるすべてのページとコントロールに対して、特定の ASP.NET ページ ディレクティブとコントロール ディレクティブをグローバルに設定できます。これには、ページおよびユーザー コントロールのコンパイラが ASP.NET Web フォーム ページ (.aspx) ファイルおよびユーザー コントロール (.ascx) ファイルを処理するときに使用する設定を指定する、次のページ レベル ディレクティブが含まれます。

pages 要素は、tagMapping 要素を介して、実行時にタグの種類を他のタグの種類に割り当てることもできます。

950xf363.alert_note(ja-jp,VS.90).gifメモ :

@ Page ディレクティブをマスタ ページに追加しても、マスター ページに依存するページの同じディレクティブの宣言を使用できません。代わりに、pages 構成要素を使用して、ページ ディレクティブをグローバル定義してください。

既定の構成

次の既定の pages 要素は、Machine.config ファイルまたはルート Web.config ファイルで明示的には構成されていません。ただし、これはアプリケーションにより返される既定の構成です。名前空間とコントロールは、ルート Web.config ファイル内で追加されます。

<pages 
   buffer="true" 
   enableSessionState="true" 
   enableViewState="true" 
   enableViewStateMac="true" 
   smartNavigation="false" 
   autoEventWireup="true" 
   pageBaseType="System.Web.UI.Page" 
   userControlBaseType="System.Web.UI.UserControl" 
   validateRequest="true" 
   masterPageFile="" 
   theme="" 
   styleSheetTheme="" 
   maxPageStateFieldLength="-1" 
   compilationMode="Always" 
   pageParserFilterType="" 
   viewStateEncryptionMode="Auto" 
   maintainScrollPositionOnPostBack="false" 
   asyncTimeout="45"
>
   <namespaces>
      <clear />
   </namespaces>
   <tagMapping>
      <clear />
   </tagMapping>
</pages>

使用例

複数のページ構成設定を指定する方法を次のコード例に示します。

<configuration>
   <system.web>
      <pages buffer="true"
         enableSessionState="true"
         autoEventWireup="true"
         maintainScrollPositionOnPostBack="true"
         masterPageFile = "~/Masters/Page1.master" />
  </system.web>
</configuration>

要素情報

構成セクション ハンドラ

PagesSection

構成メンバ

Pages

Page

構成できる場所

Machine.config

ルート レベルの Web.config

アプリケーション レベルの Web.config

仮想ディレクトリ レベルまたは物理ディレクトリ レベルの Web.config

必要条件

Microsoft Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0

.NET Framework Version 1.0、1.1、または 2.0

Visual Studio 2003 または Visual Studio 2005

参照

処理手順

方法 : Location の設定を使用して特定のディレクトリを構成する

方法 : ASP.NET 構成設定をロックする

概念

ASP.NET 構成ファイルの階層と継承

ASP.NET 構成の保護

参照

configuration 要素 (全般設定スキーマ)

pages の controls 要素 (ASP.NET 設定スキーマ)

pages の namespaces 要素 (ASP.NET 設定スキーマ)

pages の tagMapping 要素 (ASP.NET 設定スキーマ)

system.web 要素 (ASP.NET 設定スキーマ)

@ Page

System.Configuration

System.Web.Configuration

Page

PagesSection

その他の技術情報

全般構成設定 (ASP.NET)

ASP.NET 構成設定

ASP.NET Web サイトの管理

ASP.NET 構成 API