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

[アーティクル]
05/27/2012

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

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

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

属性および要素

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

属性

なし。

子要素

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

親要素

要素	Description
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 設定スキーマ)

属性および要素

属性

子要素

親要素

解説

既定の構成

使用例

要素情報

参照

処理手順

Reference

概念

その他の技術情報

その他のリソース