MemoryCache 建構函式

定義

命名空間:

System.Runtime.Caching

組件:

System.Runtime.Caching.dll

套件:

System.Runtime.Caching v11.0.0-preview.2.26159.112

多載

名稱	Description
MemoryCache(String, NameValueCollection)	初始化 MemoryCache 類別的新執行個體。
MemoryCache(String, NameValueCollection, Boolean)	初始化 MemoryCache 類別的新執行個體。

MemoryCache(String, NameValueCollection)

來源:

MemoryCache.cs

初始化 MemoryCache 類別的新執行個體。

public MemoryCache(string name, System.Collections.Specialized.NameValueCollection config = default);

new System.Runtime.Caching.MemoryCache : string * System.Collections.Specialized.NameValueCollection -> System.Runtime.Caching.MemoryCache

Public Sub New (name As String, Optional config As NameValueCollection = Nothing)

參數

name

String

用來查詢設定資訊的名稱。

Note 並非每個名稱都必須有設定資訊。

若存在匹配的設定項目，則使用該設定資訊來配置實 MemoryCache 例。 若不存在匹配的組態條目，則可透過該 Name 屬性存取該名稱，因為指定的名稱與實 MemoryCache 例相關聯。 關於記憶體快取配置的資訊，請參見 MemoryCacheElement。

config

NameValueCollection

一組用於設定快取的名稱/值對設定資訊。

例外狀況

ArgumentNullException

name 為 null。

ArgumentException

參數中的 config 名稱或值無法解析。

ConfigurationException

集合中的 config 某個值無效。

備註

當類別初始化時 MemoryCache ，會檢查可能被建構子中可選 config 參數覆蓋的組態項目。 你可以在參數 config 中傳遞以下參數。 所有值都可以以整數傳遞。

• CacheMemoryLimitMegabytes

• PhysicalMemoryLimitPercentage

• PollingInterval

當此建構子被呼叫時，首先會從應用程式設定檔中取得設定設定。 若應用程式設定檔中不存在設定項目，則僅套用該檔案 config 所提供的設定。 如果應用程式設定中的設定項目存在，且同時傳遞 config資訊，則 中的 config 資訊會覆蓋從設定檔讀取的資訊。

分配給快取實例的名稱值有兩種使用方式：

• 幫助你在多個實例存在時追蹤多個快取實例。

• 在實例初始化時 MemoryCache ，參考設定檔中的設定。

  備註

  目前沒有機制強制快取實例的唯一名稱。 因此，有可能擁有多個名稱相同的快取實例。

  謹慎

  除非必要，否則不要建立 MemoryCache 實例。 如果你在客戶端和網頁應用程式中建立快取實例，實 MemoryCache 例應該在應用程式生命週期的早期建立。 你必須只建立應用程式中將使用的快取實例數量，並將快取實例的參考資料儲存在可全域存取的變數中。 例如，在 ASP.NET 應用程式中，你可以將參考資料儲存在應用程式狀態。 如果你在應用程式中只建立一個快取實例，使用預設快取，並在需要存取快取時從屬性 Default 取得該快取的參考。

MemoryCache(String, NameValueCollection, Boolean)

來源:

MemoryCache.cs

初始化 MemoryCache 類別的新執行個體。

public:
 MemoryCache(System::String ^ name, System::Collections::Specialized::NameValueCollection ^ config, bool ignoreConfigSection);

public MemoryCache(string name, System.Collections.Specialized.NameValueCollection config, bool ignoreConfigSection);

new System.Runtime.Caching.MemoryCache : string * System.Collections.Specialized.NameValueCollection * bool -> System.Runtime.Caching.MemoryCache

Public Sub New (name As String, config As NameValueCollection, ignoreConfigSection As Boolean)

參數

name

String

用來查詢設定資訊的名稱。

config

NameValueCollection

一組用於設定快取的名稱/值對設定資訊。

ignoreConfigSection

Boolean

指示是否應忽略配置區塊。