<namedCaches> 要素 (キャッシュ設定)

  • [アーティクル]

名前付き MemoryCache インスタンスの構成設定のコレクションを指定します。 NamedCaches プロパティは、構成ファイルの 1 つ以上の namedCaches 要素から構成設定のコレクションを参照します。

configuration
  <system.runtime.caching>
    <memoryCache>
      <namedCaches>

構文

<namedCaches>  
  <add name="Default"/>
</namedCaches>

種類

None

属性および要素

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

属性

属性 説明
cacheMemoryLimitMegabytes MemoryCache のインスタンスを拡張できる最大許容サイズをメガバイト単位で指定する整数値。 既定値は 0 であり、これは MemoryCache クラスの自動サイズ調整ヒューリスティックが既定で使用されることを意味します。
name キャッシュの名前。
physicalMemoryLimitPercentage 物理的にインストールされたコンピューター メモリのうち、キャッシュで使用できる最大パーセンテージを指定する 0 ～ 100 の整数値。 既定値は 0 であり、これは MemoryCache クラスの自動サイズ調整ヒューリスティックが既定で使用されることを意味します。
pollingInterval 時間間隔を示す値。この値を超えると、キャッシュの実装によりキャッシュ インスタンスに設定されている絶対およびパーセントのメモリ制限と現在のメモリ負荷が比較されます。 この値は "HH:MM:SS" 形式で入力します。

子要素

要素 説明
<add> 名前付きキャッシュを、メモリ キャッシュの namedCaches コレクションに追加します。
<clear> メモリ キャッシュの namedCaches コレクションを消去します。
<remove> 名前付きキャッシュ エントリを、メモリ キャッシュの namedCaches コレクションから削除します。

親要素

要素 説明
<configuration> 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素を指定します。
<memoryCache> MemoryCache クラスに基づくキャッシュを構成するために使用される要素を定義します。
<system.runtime.caching> .NET Framework に組み込まれているアプリケーションに出力キャッシュを実装できるようにするタイプが含まれます。

解説

Web.config ファイルのメモリ キャッシュ構成セクションには、namedCaches コレクションの add、remove、clear の各属性を含めることができます。 各 namedCaches エントリは、name 属性によって一意に識別されます。

メモリ キャッシュ エントリのインスタンスを取得するには、アプリケーション構成ファイル内の情報を参照します。 既定では、構成ファイルにエントリが存在するのは既定のキャッシュ インスタンスだけです。 既定のキャッシュ インスタンスは、Default プロパティから返されるインスタンスです。

name 属性を "Default" に設定した場合、要素では既定のメモリ キャッシュ インスタンスが使用されます。

例

次の例は、name 属性を "Default" に設定することで、キャッシュの名前を既定のキャッシュ エントリ名に設定する方法を示しています。

cacheMemoryLimitMegabytes 属性および physicalMemoryPercentage 属性はゼロに設定されます。 これらの属性をゼロに設定すると、MemoryCache クラスの自動サイズ調整ヒューリスティックが使用されることになります。 キャッシュの実装では、現在のメモリ負荷と絶対およびパーセントのメモリ制限が 2 分ごとに比較されます。

<configuration>  
  
  <system.runtime.caching>  
    <memoryCache>  
      <namedCaches>  
          <add name="Default"
               cacheMemoryLimitMegabytes="0"
               physicalMemoryLimitPercentage="0"  
               pollingInterval="00:02:00" />  
      </namedCaches>  
    </memoryCache>  
  </system.runtime.caching>  
  
</configuration>

関連項目