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

[アーティクル]
08/16/2008

更新 : 2007 年 11 月

Web アプリケーションのキャッシュ設定を構成します。

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

<caching>
      <cache>...</cache>
      <outputCache>...</outputCache>
      <outputCacheSettings>...</outputCacheSettings>
   <sqlCacheDependency>...</sqlCacheDependency>
</caching>

属性と要素

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

属性

なし

子要素

要素	説明
Cache	省略可能な要素グローバルなアプリケーションのキャッシュ設定を定義します。
outputCache	省略可能な要素アプリケーション全体の出力キャッシュ設定を指定します。
outputCacheSettings	省略可能な要素アプリケーションのページに適用できる出力キャッシュ設定を指定します。
sqlCacheDependency	省略可能な要素 ASP.NET アプリケーションの SQL キャッシュ依存を構成します。

親要素

要素	説明
configuration	共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素です。
System.web	構成ファイル内に含まれる ASP.NET の構成設定のルート要素を指定します。ASP.NET Web アプリケーションを設定し、アプリケーションの動作方法を制御する構成要素を格納します。

解説

既定の構成

次の既定の caching 要素は、Machine.config ファイルやルートの Web.config ファイルでは明示的に構成されていませんが、.NET Framework version 2.0 においてアプリケーションによって返される既定の構成です。

<caching>
  <cache disableMemoryCollection = "false" 
    disableExpiration = "false" 
    privateBytesLimit = "0" 
    percentagePhysicalMemoryUsedLimit = "90" 
    privateBytesPollTime = "00:02:00"/>

  <outputCache enableOutputCache = "true" 
    enableFragmentCache = "true" 
    sendCacheControlHeader = "true" 
    omitVaryStar = "false" >
  </outputCache>

  <outputCacheSettings>
    <outputCacheProfiles>
      <clear />
      <add name = "" 
        enabled = "true" 
        duration = "-1" 
        location = "" 
        sqlDependency = "" 
        varyByCustom = "" 
        varyByControl = "" 
        varyByHeader = "" 
        varyByParam = "" 
        noStore = "false"/>
    </outputCacheProfiles>
  </outputCacheSettings>

  <sqlCacheDependency enabled = "true" 
    pollTime = "60000">
    <databases>
       <clear />
      <add name = "" 
        connectionStringName = "" 
        pollTime = "60000"/>
    </databases>
  </sqlCacheDependency>

</caching>

使用例

ページをサーバー上に 1 分間だけキャッシュし、ブラウザのタイプとメジャーバージョンに応じて別のバージョンのページを格納する例を次に示します。

<outputCacheSettings>
  <outputCacheProfiles>
    <add name="ServerOnly" 
      duration="60" 
      varyByCustom="browser" 
      location="Server" />
  </outputCacheProfiles>
</outputCacheSettings>

この方法でキャッシュする必要のあるページをデザインするときは、次のディレクティブをページに追加する必要があります。

<%@ OutputCache CacheProfile="ServerOnly" %>

詳細については、「@ OutputCache」を参照してください。

要素情報

構成セクションハンドラ	System.Web.Configuration.CacheSection System.Web.Configuration.OutputCacheSection System.Web.Configuration.OutputCacheSettingsSection System.Web.Configuration.SqlCacheDependencySection
構成メンバ	System.Web.Configuration.SystemWebCachingSectionGroup
構成できる場所	Machine.config ルートレベルの Web.config アプリケーションレベルの Web.config
必要条件	IIS 5.0、5.1、および 6.0 .NET Framework 2.0 Visual Studio 2005

参照

次の方法で共有

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

属性と要素

属性

子要素

親要素

解説

既定の構成

使用例

要素情報

参照

処理手順

概念

参照

その他の技術情報

その他のリソース