ObjectCache 類別

定義

命名空間:

System.Runtime.Caching

組件:

System.Runtime.Caching.dll

套件:

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

來源:

ObjectCache.cs

表示物件快取，並提供存取物件快取的基底方法和屬性。

public ref class ObjectCache abstract : System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>

public abstract class ObjectCache : System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string,object>>

type ObjectCache = class
    interface seq<KeyValuePair<string, obj>>
    interface IEnumerable

Public MustInherit Class ObjectCache
Implements IEnumerable(Of KeyValuePair(Of String, Object))

繼承

Object

ObjectCache

衍生

System.Runtime.Caching.MemoryCache

實作

IEnumerable<KeyValuePair<String,Object>> IEnumerable

備註

該 ObjectCache 型別是記憶體內物件快取的主要型別。 要開發自訂快取實作，你必須從該 ObjectCache 類別衍生出來。

Note

ObjectCache 類別自 .NET Framework 4 起新增。

內建 MemoryCache 類別即源自該 ObjectCache 類別。 MemoryCache 類別是 .NET Framework 4 中唯一源自 ObjectCache 類別的具體物件快取實作。

給實施者的注意事項

由於該 ObjectCache 型別僅代表常見快取函式，因此無需要求如何 ObjectCache 實例化與取得實例。 此外，也沒有要求該類別的具體實作 ObjectCache 必須是單例。

注意： MemoryCache 不是單例，但你應該只建立幾個或可能只建立一個 MemoryCache 實例，快取項目的程式碼應該使用這些實例。

當你從該類別繼承 ObjectCache 時，必須覆寫其方法。

建構函式

名稱	Description
ObjectCache()	從衍生類別中的建構子呼叫以初始化該 ObjectCache 類別。

欄位

名稱	Description
InfiniteAbsoluteExpiration	會得到一個值，表示快取條目沒有絕對有效期。
NoSlidingExpiration	表示快取條目沒有滑動過期時間。

屬性

名稱	Description
DefaultCacheCapabilities	當在衍生類別中覆寫時，會獲得快取實作所提供的特性描述。
Host	取得或設定一個管理型主機環境的參考，該環境可供實作使用 ObjectCache ，並能提供主機專屬服務給 ObjectCache 實作。
Item[String]	取得或設定該類別的 ObjectCache 預設索引器。
Name	會取得特定 ObjectCache 實例的名稱。

方法

名稱	Description
Add(CacheItem, CacheItemPolicy)	當在衍生類別中被覆寫時，會嘗試將快取條目作為 CacheItem 實例插入快取，並新增該條目應如何被驅逐的細節。
Add(String, Object, CacheItemPolicy, String)	在衍生類別中覆寫時，將快取專案插入快取中，並指定如何收回專案的相關信息。
Add(String, Object, DateTimeOffset, String)	在衍生類別中覆寫時，將快取專案插入快取中，而不覆寫任何現有的快取專案。
AddOrGetExisting(CacheItem, CacheItemPolicy)	當在衍生類別中覆寫時，會將指定的 CacheItem 物件插入快取，並指定如何將該條目被驅逐的資訊。
AddOrGetExisting(String, Object, CacheItemPolicy, String)	當在衍生類別中覆寫時，會插入快取條目，指定快取條目的鍵與值，並說明該條目將如何被驅逐。
AddOrGetExisting(String, Object, DateTimeOffset, String)	當在派生類別中覆寫時，會透過使用金鑰、快取項目的物件、絕對到期值，以及可選的區域將快取加入快取，插入快取條目。
Contains(String, String)	當在派生類別中覆寫時，會檢查快取條目是否已存在於快取中。
CreateCacheEntryChangeMonitor(IEnumerable<String>, String)	當在派生類別中被覆寫時，會建立 CacheEntryChangeMonitor 一個物件，能因應指定快取項目的變更而觸發事件。
Get(String, String)	當在衍生類別中覆寫時，會從該快取中取得指定的快取項目作為物件。
GetCacheItem(String, String)	當在衍生類別中覆寫時，會從該快取中取得指定的快取項目作為 CacheItem 實例。
GetCount(String)	當在衍生類別中被覆寫時，會取得快取中快取項目的總數。
GetEnumerator()	當在衍生類別中覆寫時，會產生一個枚舉器，可用於遍歷一組快取條目。
GetValues(IEnumerable<String>, String)	當在衍生類別中覆寫時，會得到一組對應指定鍵的快取項目。
GetValues(String, String[])	取得一組對應至指定索引鍵的快取專案。
Remove(String, String)	當在派生類別中覆寫時，會從快取中移除快取條目。
Set(CacheItem, CacheItemPolicy)	當在派生類別中覆寫時，會將快取條目以實例形式插入快取 CacheItem ，並指定如何將該條目被驅逐的資訊。
Set(String, Object, CacheItemPolicy, String)	當在衍生類別中被覆寫時，會插入快取項目。
Set(String, Object, DateTimeOffset, String)	當在衍生類別中覆寫時，會插入一個快取項目，指定基於時間的到期細節。

明確介面實作

名稱	Description
IEnumerable.GetEnumerator()	支援對通用集合的迭代。
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	支援強型別集合的反覆專案。

擴充方法

名稱	Description
ToAsyncEnumerable<TSource>(IEnumerable<TSource>)	將 IEnumerable<T> 轉換成 IAsyncEnumerable<T>。
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>)	列舉序列，併產生其內容的不可變排序集。

執行緒安全性

此類型是安全線程。