更新 : 2007 年 11 月
アプリケーション全体の出力キャッシュ設定を指定します。
configuration 要素 (全般設定スキーマ)
system.web 要素 (ASP.NET 設定スキーマ)
caching 要素 (ASP.NET 設定スキーマ)
caching の outputCache 要素 (ASP.NET 設定スキーマ)
<outputCache enableOutputCache="true|false"
enableFragmentCache="true|false"
sendCacheControlHeader="true|false"
omitVaryStar="true|false">
</outputCache>
属性と要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
説明 |
|---|---|
enableOutputCache |
省略可能な Boolean 型の属性です。 ページの出力キャッシュを有効または無効にします。 無効にした場合、プログラムまたは宣言文による設定にかかわらず、ページはキャッシュされません。 既定値は trueです。 |
enableFragmentCache |
省略可能な Boolean 型の属性です。 アプリケーションのフラグメント キャッシュを有効または無効にします。 無効にした場合、@ OutputCache ディレクティブまたは使用されているキャッシュ プロファイルにかかわらず、ページはキャッシュされません。上流のプロキシ サーバー、およびブラウザ クライアントに対し、ページ出力をキャッシュしないよう指示するキャッシュ制御ヘッダーが追加されます。 既定値は falseです。 |
sendCacheControlHeader |
省略可能な Boolean 型の属性です。 出力キャッシュ モジュールによって、既定で cache-control:private ヘッダーが送信されるかどうかを示す値を取得または設定します。 既定値は falseです。 |
omitVaryStar |
省略可能な Boolean 型の属性です。 応答における HTTP "Vary: *" ヘッダーの送信を有効または無効にします。既定の設定は false で、出力キャッシュ ページの "Vary: *" ヘッダーが送信されます。 既定値は falseです。 |
子要素
なし。
親要素
要素 |
説明 |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素です。 |
system.web |
構成ファイル内に含まれる ASP.NET の構成設定のルート要素を指定します。ASP.NET Web アプリケーションを設定し、アプリケーションの動作方法を制御する構成要素を格納します。 |
caching |
Web アプリケーションのキャッシュ設定を構成します。 |
解説
既定の構成
次の既定の outputCache 要素は、マシン構成ファイルやルートの Web.config ファイルでは明示的に構成されていませんが、.NET Framework Version 2.0 においては、アプリケーションによって返される既定の構成です。
<outputCache enableOutputCache = "true"
enableFragmentCache = "true"
sendCacheControlHeader = "true"
omitVaryStar = "false">
</outputCache>
使用例
ASP.NET アプリケーションの出力キャッシュを無効にする例を次に示します。
<outputCache enableOutputCache="false" />
要素情報
構成セクション ハンドラ |
|
構成メンバ |
|
構成できる場所 |
Machine.config ルート レベルの Web.config アプリケーション レベルの Web.config |
必要条件 |
IIS バージョン 5.0、IIS バージョン 5.1、および IIS バージョン 6.0 .NET Framework Version 2.0 Visual Studio 2005 |
参照
処理手順
チュートリアル : 出力キャッシュを使用した Web サイトのパフォーマンスの強化
方法 : Location の設定を使用して特定のディレクトリを構成する
概念
参照
system.web 要素 (ASP.NET 設定スキーマ)
caching の cache 要素 (ASP.NET 設定スキーマ)