<memoryCache> 項目 (快取設定)

定義項目，這個項目會用來設定以 MemoryCache 類別為基礎的快取。 MemoryCacheElement 類別定義可用來設定快取的 memoryCache 項目。 多個 MemoryCache 類別執行個體可以用於單一應用程式。 組態檔中的每個 memoryCache 項目都可以包含具名 MemoryCache 執行個體的設定。

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

Syntax

<memoryCache>
    <namedCaches>  
        <!-- child elements -->  
    </namedCaches>
</memoryCache>  

類型

MemoryCache 類別。

屬性和項目

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

屬性

屬性	描述
CacheMemoryLimitMegabytes	MemoryCache 物件執行個體可以成長的最大記憶體大小 (MB)。 預設值為 0，表示預設會使用 MemoryCache 類別的自動調整啟發學習法。
Name	快取組態的名稱。
PhysicalMemoryLimitPercentage	快取可使用的實體記憶體百分比。 預設值為 0，表示預設會使用 MemoryCache 類別的自動調整啟發學習法。
PollingInterval	表示時間間隔的值，在此時間之後，快取實作會比較目前的記憶體負載與針對快取執行個體所設定的絕對和百分比型記憶體限制。 此值是以 "HH:MM:SS" 格式輸入。

子元素

元素	描述
<namedCaches>	包含 namedCache 執行個體的組態設定集合。

父項目

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

備註

MemoryCache 類別是抽象 ObjectCache 類別的具體實作。 MemoryCache 類別執行個體可以與應用程式組態檔中的組態資訊一起提供。 memoryCache 組態區段包含 namedCaches 組態集合。

初始化記憶體型快取物件時，會先嘗試尋找 namedCaches 項目，而此項目符合傳遞給記憶體快取建構函式之參數中的名稱。 如果找不到 namedCaches 項目，則會從組態檔中擷取輪詢和記憶體管理資訊。

初始化程序接著會判斷是否已覆寫任何組態項目，方法是在建構函式中使用組態資訊的選擇性名稱/值組集合。 如果您在名稱/值組集合中傳遞下列任何一個值，則這些值會覆寫從組態檔取得的資訊︰

• CacheMemoryLimitMegabytes

• PhysicalMemoryLimitPercentage

• PollingInterval

範例

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

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

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

另請參閱

• 使用組態檔設定應用程式
• MemoryCache
• <system.runtime.caching> 項目 (快取設定)
• <namedCaches> 元素 (快取設定)