MemoryCache 類別

定義

命名空間:

System.Runtime.Caching

組件:

System.Runtime.Caching.dll

套件:

System.Runtime.Caching v8.0.0

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

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 類別。 如果您已使用 ASP.NET 類別，類別 MemoryCache 有許多屬性和方法可用來存取快取。如果您已使用 ASP.NET Cache 類別，則此快取會很熟悉。 和 MemoryCache 類別的主要 Cache 差異在於類別已變更， MemoryCache 讓.NET Framework未 ASP.NET 應用程式使用類別。 例如，類別 MemoryCache 對元件沒有相 System.Web 依性。 另一個差異在於，您可以建立 類別的 MemoryCache 多個實例，以便用於相同應用程式和相同 AppDomain 實例。

類別 MemoryCache 不允許 null 作為快取中的值。 任何嘗試新增或變更值為 的 null 快取專案將會失敗。

類型 MemoryCache 不會實 作快取區域。 因此，當您呼叫 MemoryCache 實作包含區域參數之基底方法的方法時，請勿傳遞 參數的值。 使用 region 參數的方法全都會提供預設值 null 。 例如， MemoryCache.AddOrGetExisting 方法多載具有 regionName 預設值為 null 的參數。

建構函式

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

屬性

CacheMemoryLimit	取得電腦上可供快取使用的記憶體數量 (以位元組為單位)。
Default	取得預設 MemoryCache 執行個體的參考。
DefaultCacheCapabilities	取得快取提供之功能的說明。
Item[String]	使用 MemoryCache 類別之執行個體的預設索引子屬性，取得或設定快取中的值。
Name	取得快取的名稱。
PhysicalMemoryLimit	取得快取可使用的實體記憶體百分比。
PollingInterval	取得快取更新其記憶體統計資料之前的最多所需時間。

方法

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 類別的目前執行個體所使用的資源全部釋出。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Get(String, String)	從快取傳回項目。
GetCacheItem(String, String)	以 CacheItem 執行個體形式從快取傳回指定的項目。
GetCount(String)	傳回快取中的快取項目總數。
GetEnumerator()	建立列舉程式，此列舉程式可用來逐一查看快取項目的集合。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLastSize(String)	取得具名區域的大小。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
GetValues(IEnumerable<String>, String)	傳回對應至指定之索引鍵的一組快取項目。
GetValues(String, String[])	取得對應至指定索引鍵的快取項目組。 (繼承來源 ObjectCache)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Remove(String, CacheEntryRemovedReason, String)	使用原因，從快取中移除快取項目。
Remove(String, String)	從快取中移除一個快取項目。
Set(CacheItem, CacheItemPolicy)	使用 CacheItem 執行個體提供快取項目所需的索引鍵和值，以在快取中插入快取項目。
Set(String, Object, CacheItemPolicy, String)	使用索引鍵、值和清除，在快取區中插入快取項目。
Set(String, Object, DateTimeOffset, String)	使用索引鍵、值並指定以時間為基礎的到期詳細資訊，在快取區中插入快取項目。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Trim(Int32)	從快取物件移除指定百分比的快取項目。

明確介面實作

IEnumerable.GetEnumerator()	提供在泛型集合上執行反覆項目的支援。
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	支援在強類型集合上反覆運算。 (繼承來源 ObjectCache)

擴充方法

執行緒安全性

此型別具備執行緒安全。

另請參閱

• ObjectCache
• 逐步解說：在 ASP.NET 中快取應用程式資料
• .NET Framework 應用程式中的快取