<namedCaches> 元素 (快取設定)

  • 發行項

指定具名 MemoryCache 執行個體的組態設定集合。 NamedCaches 屬性會參考組態檔中一或多個 namedCaches 元素的組態設定集合。

<設定>
  <system.runtime.caching>
    <memoryCache>
      <namedCaches>

Syntax

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

類型

None

屬性和項目

下列章節說明屬性、子元素和父元素。

屬性

屬性 描述
cacheMemoryLimitMegabytes 整數值指示 MemoryCache 執行個體可以成長到的最大允許大小，以 MB 為單位。 預設值為 0，表示預設會使用 MemoryCache 類別的自動調整啟發學習法。
name 快取的名稱。
physicalMemoryLimitPercentage 介於 0 到 100 之間的整數值，指示快取可使用的實際安裝電腦記憶體的最大百分比。 預設值為 0，表示預設會使用 MemoryCache 類別的自動調整啟發學習法。
pollingInterval 表示時間間隔的值，在此時間之後，快取實作會比較目前的記憶體負載與針對快取執行個體所設定的絕對和百分比型記憶體限制。 此值是以 "HH:MM:SS" 格式輸入。

子元素

元素 描述
<add> 將具名快取新增到記憶體快取的 namedCaches 集合。
<清除> 清除記憶體快取的 namedCaches 集合。
<移除> 從記憶體快取的 namedCaches 集合移除具名快取項目。

父項目

元素 描述
<configuration> 指定 Common Language Runtime 和 .NET Framework 應用程式所使用的每個組態檔中的根項目。
<memoryCache> 定義項目，這個項目會用來設定以 MemoryCache 類別為基礎的快取。
<system.runtime.caching> 包含類型，可讓您在內建于.NET Framework的應用程式中實作輸出快取。

備註

Web.config 檔案的記憶體快取組態區段可以包含 namedCaches 集合的 add、remove 和 clear 屬性。 每個 namedCaches 項目都是由 name 屬性唯一識別。

您可以參考應用程式組態檔中的資訊，以擷取記憶體快取專案的執行個體。 根據預設，只有預設快取執行個體具有組態檔中的項目。 預設快取執行個體是從 Default 屬性傳回的執行個體。

如果您將名稱屬性設定為「Default」，元素會使用預設記憶體快取執行個體。

範例

下列範例示範如何將快取的名稱設定為預設快取專案名稱，方法是將 name 屬性設定為「Default」。

cacheMemoryLimitMegabytes 屬性和 physicalMemoryPercentage 屬性都設定為零。 將這些屬性設定為零表示會使用 MemoryCache 類別的自動調整啟發學習法。 快取實作會每兩分鐘比較目前記憶體負載與絕對和以百分比為基礎的記憶體限制。

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

另請參閱