caching の outputCacheSettings の outputCacheProfiles 要素 (ASP.NET 設定スキーマ)
[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]
@OutputCache ディレクティブを指定するためにページに適用できるキャッシュ設定のグループを格納します。
<outputCacheProfiles>
<add.../>
<clear />
<remove.../>
</outputCacheProfiles>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
なし。
子要素
要素 |
Description |
|---|---|
add |
省略可能な要素です。 構成コレクションに OutputCacheProfile オブジェクトを追加します。 |
clear |
省略可能な要素です。 構成コレクションからすべての OutputCacheProfile オブジェクトを削除します。 |
remove |
省略可能な要素です。 指定された名前を持つ OutputCacheProfile オブジェクトを構成コレクションから削除します。 |
親要素
要素 |
Description |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素です。 |
system.web |
構成ファイル内に含まれる ASP.NET の構成設定のルート要素を指定します。 ASP.NET Web アプリケーションを設定し、アプリケーションの動作方法を制御する構成要素を格納します。 |
caching |
Web アプリケーションのキャッシュ設定を構成します。 |
outputCacheSettings |
ASP.NET アプリケーションのページとコントロールに適用できる出力キャッシュ設定を指定します。 |
解説
既定の構成
次の既定の outputCacheProfiles 要素は、マシン構成ファイルやルートの Web.config ファイルでは明示的に構成されていませんが、.NET Framework Version 2.0 においては、アプリケーションによって返される既定の構成です。
<outputCacheSettings>
<outputCacheProfiles>
<add name = ""
enabled = "true"
duration = "-1"
location = ""
sqlDependency = ""
varyByCustom = ""
varyByControl = ""
varyByHeader = ""
varyByParam = ""
noStore = "false"/>
</outputCacheProfiles>
</outputCacheSettings>
<outputCacheSettings>
<outputCacheProfiles>
<clear />
</outputCacheProfiles>
</outputCacheSettings>
使用例
ページをサーバー上に 1 分間だけキャッシュし、ブラウザーのタイプとメジャー バージョンに応じて別のバージョンのページを格納する例を次に示します。
<outputCacheSettings>
<outputCacheProfiles>
<add name="ServerOnly"
duration="60"
varyByCustom="browser"
location="Server" />
</outputCacheProfiles>
</outputCacheSettings>
この方法でキャッシュする必要のあるページをデザインするときは、次のディレクティブをページに追加する必要があります。
<%@ OutputCache CacheProfile="ServerOnly" %>
詳細については、「@ OutputCache」を参照してください。
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
Machine.config ルート レベルの Web.config アプリケーション レベルの Web.config |
要件 |
IIS 5.0、5.1、および 6.0 .NET Framework 2.0 Visual Studio 2005 |
参照
処理手順
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Reference
system.web 要素 (ASP.NET 設定スキーマ)
caching の outputCacheSettings 要素 (ASP.NET 設定スキーマ)
caching の outputCacheProfiles の add 要素 (ASP.NET 設定スキーマ)
caching の outputCacheProfiles の clear 要素 (ASP.NET 設定スキーマ)
caching の outputCacheProfiles の remove 要素 (ASP.NET 設定スキーマ)
概念
ASP.NET Configuration File Hierarchy