名前付き MemoryCache インスタンスの構成設定のコレクションを指定します。 NamedCaches プロパティは、構成ファイルの 1 つ以上の namedCaches 要素の構成設定のコレクションを参照します。
<namedCaches>
<add name="default"
</namedCaches>
None
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
説明 |
---|---|
CacheMemoryLimitMegabytes |
MemoryCache のインスタンスについて許可される最大サイズ (MB 単位) を指定する整数値。 既定値は 0 です。これは、MemoryCache クラスの自動サイズ変更ヒューリスティックが既定で使用されることを意味します。 |
Name |
キャッシュの名前。 |
PhysicalMemoryLimitPercentage |
キャッシュで使用できる物理的にインストールされたコンピューター メモリの最大パーセンテージを指定する 0 ~ 100 の整数値。 既定値は 0 です。これは、MemoryCache クラスの自動サイズ変更ヒューリスティックが既定で使用されることを意味します。 |
PollingInterval |
キャッシュの実装が、現在のメモリ負荷を、キャッシュ インスタンスに設定されているメモリ制限の絶対値および割合と比較する時間間隔を示す値。 この値は "HH:MM:SS" の形式で入力されます。 |
子要素
要素 |
説明 |
---|---|
名前付きキャッシュをメモリ キャッシュの namedCaches コレクションに追加します。 |
|
メモリ キャッシュの namedCaches コレクションを削除します。 |
|
メモリ キャッシュの namedCaches コレクションから、名前付きキャッシュ エントリを削除します。 |
親要素
要素 |
説明 |
---|---|
MemoryCache クラスに基づいたキャッシュの構成に使用される要素を定義します。 |
解説
Web.config ファイルのメモリ キャッシュ構成セクションには、namedCaches コレクションの add、remove、および clear 属性を含めることができます。 各 namedCaches エントリは、name 属性によって一意に識別されます。
アプリケーション構成ファイル内の情報を参照することにより、メモリ キャッシュ エントリのインスタンスを取得できます。 既定では、既定のキャッシュ インスタンスのみが構成ファイルにエントリを持ちます。 既定のキャッシュ インスタンスは、Default プロパティから返されるインスタンスです。
名前属性を "default" に設定した場合、要素では既定のメモリ キャッシュ インスタンスが使用されます。
使用例
name 属性を "default" に設定して、キャッシュの名前を既定のキャッシュ エントリ名に設定する方法を次の例に示します。
cacheMemoryLimitMegabytes 属性と physicalMemoryPercentage 属性は 0 に設定されています。 これらの属性を 0 に設定すると、MemoryCache クラスの自動サイズ変更ヒューリスティックが使用されます。 キャッシュの実装は、現在のメモリ負荷を、メモリ制限の絶対値および割合と 2 分ごとに比較します。
<configuration>
<system.runtime.caching>
<memoryCache>
<namedCaches>
<add name="default"
cacheMemoryLimitMegabytes="0"
physicalMemoryPercentage="0"
pollingInterval="00:02:00" />
</namedCaches>
</memoryCache>
</system.runtime.caching>
</configuration>