MemoryCache 類別

定義

命名空間:

System.Runtime.Caching

組件:

System.Runtime.Caching.dll

套件:

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

來源:

MemoryCache.cs

表示實作記憶體內部快取的類型。

public ref class MemoryCache : System::Runtime::Caching::ObjectCache, IDisposable

public class MemoryCache : System.Runtime.Caching.ObjectCache, IDisposable

type MemoryCache = class
    inherit ObjectCache
    interface IEnumerable
    interface IDisposable

Public Class MemoryCache
Inherits ObjectCache
Implements IDisposable

繼承

Object

ObjectCache

MemoryCache

實作

IEnumerable IDisposable

範例

下列範例會宣告預設記憶體快取實例的參考。 快取條目使用 CacheItemPolicy 物件提供快取條目的驅逐與到期細節。 它也會使用 ChangeMonitor 物件來監控原始資料（即檔案）在檔案系統上的狀態。

Private Sub btnGet_Click(ByVal sender As Object, ByVal e As EventArgs)
    Dim cache As ObjectCache = MemoryCache.[Default]
    Dim fileContents As String = TryCast(cache("filecontents"), String)

    If fileContents Is Nothing Then
        Dim policy As New CacheItemPolicy()
        Dim filePaths As New List(Of String)()
        filePaths.Add("c:\cache\example.txt")

        policy.ChangeMonitors.Add(New HostFileChangeMonitor(filePaths))

        ' Fetch the file contents.
        fileContents = File.ReadAllText("c:\cache\example.txt")

        cache.[Set]("filecontents", fileContents, policy)
    End If

    Label1.Text = fileContents
End Sub

private void btnGet_Click(object sender, EventArgs e)
{
    ObjectCache cache = MemoryCache.Default;
    string fileContents = cache["filecontents"] as string;

    if (fileContents == null)
    {
        CacheItemPolicy policy = new CacheItemPolicy();

        List<string> filePaths = new List<string>();
        filePaths.Add("c:\\cache\\example.txt");

        policy.ChangeMonitors.Add(new
        HostFileChangeMonitor(filePaths));

        // Fetch the file contents.
        fileContents =
            File.ReadAllText("c:\\cache\\example.txt");

        cache.Set("filecontents", fileContents, policy);
    }

    Label1.Text = fileContents;
}

備註

類別 MemoryCache 是抽象 ObjectCache 類的具體實作。

注意

MemoryCache 類與 ASP.NET Cache 類相似。 MemoryCache 類別擁有許多存取快取的屬性與方法，如果你用過 ASP.NET Cache 類別，應該會很熟悉。 Cache 與 MemoryCache 類別的主要差異在於，MemoryCache 類別被修改為可供非 ASP.NET 應用程式的 .NET Framework 應用程式使用。 例如，該 MemoryCache 類別對組裝沒有任何依賴 System.Web 關係。 另一個差異是你可以在同一個應用程式和同AppDomain一個實例中建立多個類別實例MemoryCache。

該 MemoryCache 類別不允許 null 作為快取中的值。 任何嘗試新增或更改值為 的 null 快取條目都會失敗。

該 MemoryCache 類型不實作 快取區域。 因此，當你呼叫 MemoryCache 實作包含區域參數的基礎方法時，不要傳遞該參數的值。 使用區域參數的方法都會提供預設 null 值。 例如， MemoryCache.AddOrGetExisting 方法過載有一個 regionName 參數，其預設值為 null。

建構函式

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

屬性

名稱	Description
CacheMemoryLimit	取得計算機上的記憶體數量，以位元組為單位，可供快取使用。
Default	會得到一個預設 MemoryCache 實例的參考。
DefaultCacheCapabilities	取得快取所提供的功能描述。
Item[String]	透過使用該類別實例 MemoryCache 的預設索引器屬性，取得或設定快取中的值。
Name	取得快取的名稱。
PhysicalMemoryLimit	取得系統物理記憶體總使用量中快取開始驅逐條目的百分比。
PollingInterval	取得快取更新其記憶體統計數據的最長時間。

方法

名稱	Description
Add(CacheItem, CacheItemPolicy)	將快取條目插入為 CacheItem 實例，並新增如何驅逐該條目。
Add(String, Object, CacheItemPolicy, String)	在衍生類別中覆寫時，將快取專案插入快取中，並指定如何收回專案的相關信息。 (繼承來源 ObjectCache)
Add(String, Object, DateTimeOffset, String)	在衍生類別中覆寫時，將快取專案插入快取中，而不覆寫任何現有的快取專案。 (繼承來源 ObjectCache)
AddOrGetExisting(CacheItem, CacheItemPolicy)	使用指定的 CacheItem 實例將快取條目加入快取，並提供如何驅逐該條目。
AddOrGetExisting(String, Object, CacheItemPolicy, String)	使用指定的索引鍵和值，以及要如何收回快取的指定詳細數據，將快取專案插入快取中。
AddOrGetExisting(String, Object, DateTimeOffset, String)	使用指定的索引鍵和值和絕對到期值，將快取專案加入快取中。
Contains(String, String)	判斷快取專案是否存在於快取中。
CreateCacheEntryChangeMonitor(IEnumerable<String>, String)	建立 CacheEntryChangeMonitor 一個物件，能因指定快取項目的變更而觸發事件。
Dispose()	釋放目前類別實例 MemoryCache 所使用的所有資源。
Get(String, String)	從快取傳回專案。
GetCacheItem(String, String)	會從快取中回傳指定的條目作為 CacheItem 實例。
GetCount(String)	傳回快取中的快取項目總數。
GetEnumerator()	建立列舉值，可用來逐一查看快取專案的集合。
GetLastSize(String)	取得具名區域的大小。
GetValues(IEnumerable<String>, String)	傳回一組對應至指定索引鍵的快取專案。
GetValues(String, String[])	取得一組對應至指定索引鍵的快取專案。 (繼承來源 ObjectCache)
Remove(String, CacheEntryRemovedReason, String)	使用原因從快取中移除快取專案。
Remove(String, String)	從快取中移除快取專案。
Set(CacheItem, CacheItemPolicy)	透過使用 CacheItem 實例提供快取條目的鍵與值，插入快取項目。
Set(String, Object, CacheItemPolicy, String)	使用索引鍵和值和收回，將快取專案插入快取中。
Set(String, Object, DateTimeOffset, String)	使用索引鍵和值將快取專案插入快取中，並指定以時間為基礎的到期詳細數據。
Trim(Int32)	從快取物件中移除指定的快取專案百分比。

明確介面實作

名稱	Description
IEnumerable.GetEnumerator()	提供對泛型集合反覆項目的支援。
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	支援強型別集合的反覆專案。 (繼承來源 ObjectCache)

擴充方法

名稱	Description
ToAsyncEnumerable<TSource>(IEnumerable<TSource>)	會產生 IAsyncEnumerable<T> 一個新的，會迭 source代 。
ToFrozenDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器和項目選取器函式，從 FrozenDictionary<TKey,TValue> 建立 IEnumerable<T>。
ToFrozenDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	根據指定的鍵選擇函式從 FrozenDictionary<TKey,TValue> a 建立 。IEnumerable<T>
ToFrozenSet<T>(IEnumerable<T>, IEqualityComparer<T>)	建立 FrozenSet<T> 一個符合指定值的 。
ToImmutableArray<TSource>(IEnumerable<TSource>)	從指定的集合建立不可變的陣列。
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>, IEqualityComparer<TValue>)	列舉和轉換序列，並使用指定的索引鍵和值比較子產生其內容的不可變字典。
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>)	列舉和轉換序列，並使用指定的索引鍵比較子產生其內容的不可變字典。
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	列舉和轉換序列，併產生其內容的不可變字典。
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	根據序列的一些轉換，建構不可變的字典。
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	從現有的專案集合建構不可變的字典，將轉換函式套用至來源索引鍵。
ToImmutableHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	列舉序列、產生其內容的不可變哈希集，並使用集合類型的指定相等比較子。
ToImmutableHashSet<TSource>(IEnumerable<TSource>)	列舉序列，併產生其內容的不可變哈希集。
ToImmutableList<TSource>(IEnumerable<TSource>)	列舉序列，併產生其內容的不可變清單。
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>, IEqualityComparer<TValue>)	列舉和轉換序列，並使用指定的索引鍵和值比較子產生其內容的不可變排序字典。
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>)	列舉和轉換序列，並使用指定的索引鍵比較子產生其內容的不可變排序字典。
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	列舉和轉換序列，併產生其內容的不可變排序字典。
ToImmutableSortedSet<TSource>(IEnumerable<TSource>, IComparer<TSource>)	列舉序列、產生其內容的不可變排序集，並使用指定的比較子。
ToImmutableSortedSet<TSource>(IEnumerable<TSource>)	列舉序列，併產生其內容的不可變排序集。

執行緒安全性

此類型是安全線程。

另請參閱

• ObjectCache
• .NET框架應用中的快取