定義用來設定以 類別為基礎的快取的專案 MemoryCache 。 類別 MemoryCacheElement 會定義可用來設定快取的 memoryCache 元素。 類別的 MemoryCache 多個實例可以在單一應用程式中使用。
memoryCache組態檔中的每個專案都可以包含具名MemoryCache實例的設定。
<配置>
<system.runtime.caching>
<記憶快取>
語法
<memoryCache>
<namedCaches>
<!-- child elements -->
</namedCaches>
</memoryCache>
類型
MemoryCache 類別。
屬性和元素
以下部分介紹屬性、子元素和父元素。
屬性
| 屬性 | 說明 |
|---|---|
CacheMemoryLimitMegabytes |
對象實例 MemoryCache 可以成長到的最大記憶體大小,以 MB 為單位。 默認值為 0,這表示 MemoryCache 預設會使用 類別的自動調整啟發學習法。 (此設定僅適用於 .Net Framework。 |
Name |
快取組態的名稱。 |
PhysicalMemoryLimitPercentage |
系統上(由所有進程)開始收回專案之系統物理記憶體使用量總計的百分比。 默認值為 0,這表示 MemoryCache 預設會使用 類別的自動調整啟發學習法。 |
PollingInterval |
值,指出快取實作之後的時間間隔會比較目前記憶體負載與快取實例所設定的絕對和以百分比為基礎的記憶體限制。 值會以 「HH:MM:SS」 格式輸入。 |
子專案
| 元素 | 說明 |
|---|---|
| <namedCaches> | 包含實例的組態設定 namedCache 集合。 |
父元素
| 元素 | 說明 |
|---|---|
| <配置> | 指定 Common Language Runtime 和 .NET Framework 應用程式所使用的每個組態檔中的根元素。 |
| <system.runtime.caching> | 包含類型,可讓您在 .NET Framework 內建的應用程式中實作輸出快取。 |
備註
類別 MemoryCache 是抽象 ObjectCache 類的具體實作。 類別的 MemoryCache 實例可以透過來自應用程式組態檔的組態資訊來提供。
memoryCache 組態區段包含組namedCaches態集合。
初始化記憶體型快取物件時,會先嘗試尋找 namedCaches 符合傳遞至記憶體快取建構函式之參數中名稱的專案。
namedCaches如果找到專案,則會從組態檔擷取輪詢和記憶體管理資訊。
然後,初始化程式會使用建構函式中組態資訊的名稱/值組選擇性集合,判斷是否已覆寫任何組態專案。 如果您在名稱/值組集合中傳遞下列任何一個值,這些值會覆寫從組態檔取得的資訊:
範例
下列範例示範如何將 屬性設定為 “Default”,將對象的名稱 MemoryCache 設定 name 為預設快取物件名稱。
屬性 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>