MemoryCache Klasse

Definition

Namespace:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Paket:

System.Runtime.Caching v8.0.0

Quelle:

MemoryCache.cs

Stellt den Typ dar, der einen Cache im Arbeitsspeicher implementiert.

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

Vererbung

Object

ObjectCache

MemoryCache

Implementiert

IEnumerable IDisposable

Beispiele

Im folgenden Beispiel wird ein Verweis auf den Standardspeichercache instance deklariert. Der Cacheeintrag verwendet ein CacheItemPolicy -Objekt, um Entfernungs- und Ablaufdetails für den Cacheeintrag bereitzustellen. Außerdem wird ein ChangeMonitor -Objekt verwendet, um den Zustand der Quelldaten (bei dem es sich um eine Datei handelt) im Dateisystem zu überwachen.

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;
}

Hinweise

Die MemoryCache -Klasse ist eine konkrete Implementierung der abstrakten ObjectCache -Klasse.

Hinweis

Die MemoryCache -Klasse ähnelt der ASP.NET-Klasse Cache . Die MemoryCache -Klasse verfügt über viele Eigenschaften und Methoden für den Zugriff auf den Cache, die Ihnen vertraut sind, wenn Sie die ASP.NET-Klasse Cache verwendet haben. Die Standard Unterschiede zwischen den Cache Klassen und MemoryCache bestehen darin, dass die MemoryCache Klasse geändert wurde, um sie von .NET Framework Anwendungen nutzbar zu machen, die nicht ASP.NET Anwendungen sind. Beispielsweise weist die MemoryCache -Klasse keine Abhängigkeiten von der Assembly auf System.Web . Ein weiterer Unterschied besteht darin, dass Sie mehrere Instanzen der -Klasse für die MemoryCache Verwendung in derselben Anwendung und in derselben AppDomain instance erstellen können.

Die MemoryCache -Klasse lässt null keinen Wert im Cache zu. Jeder Versuch, einen Cacheeintrag mit dem Wert von null hinzuzufügen oder zu ändern, schlägt fehl.

Der MemoryCache Typ implementiert keine Cacheregionen. Wenn Sie Methoden aufrufen MemoryCache , die Basismethoden implementieren, die einen Parameter für Regionen enthalten, übergeben Sie daher keinen Wert für den Parameter. Die Methoden, die den Regionsparameter verwenden, liefern alle einen Standardwert null . Beispielsweise verfügt die MemoryCache.AddOrGetExisting Methodenüberladung über einen regionName Parameter, dessen Standardwert ist null.

Konstruktoren

MemoryCache(String, NameValueCollection)	Initialisiert eine neue Instanz der MemoryCache-Klasse.
MemoryCache(String, NameValueCollection, Boolean)	Initialisiert eine neue Instanz der MemoryCache-Klasse.

Eigenschaften

CacheMemoryLimit	Ruft den Speicherplatz auf dem Computer, der vom Cache verwendet werden kann, in Bytes ab.
Default	Ruft einen Verweis auf die MemoryCache-Standardinstanz ab.
DefaultCacheCapabilities	Ruft eine Beschreibung der Funktionen ab, die der Cache bereitstellt.
Item[String]	Ruft einen Wert im Cache mithilfe der Standardindexereigenschaft für eine Instanz der MemoryCache-Klasse ab, oder legt ihn fest.
Name	Ruft den Namen des Caches ab.
PhysicalMemoryLimit	Ruft den Prozentsatz des physischen Arbeitsspeichers ab, der vom Cache verwendet werden kann.
PollingInterval	Ruft die maximale Zeit ab, nach der der Cache die Arbeitsspeicherstatistik aktualisiert.

Methoden

Add(CacheItem, CacheItemPolicy)	Fügt einen Cacheeintrag als eine CacheItem-Instanz ein und fügt Details wie der Eintrag zu entfernen ist im Cache hinzu.
Add(String, Object, CacheItemPolicy, String)	Fügt beim Überschreiben in einer abgeleiteten Klasse einen Cacheeintrag im Cache ein und gibt Informationen darüber an, wie der Eintrag entfernt wird. (Geerbt von ObjectCache)
Add(String, Object, DateTimeOffset, String)	Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, fügt sie einen Cacheeintrag in den Cache ein, ohne einen vorhandenen Cacheeintrag zu überschreiben. (Geerbt von ObjectCache)
AddOrGetExisting(CacheItem, CacheItemPolicy)	Fügt einen Cacheeintrag unter Verwendung der angegebenen CacheItem-Instanz und Details zur Entfernung des Eintrags im Cache hinzu.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Fügt einen Cacheeintrag unter Verwendung des angegebenen Schlüssels und Werts und der angegebenen Details zur Entfernung in den Cache ein.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Fügt einen Cacheeintrag unter Verwendung des angegebenen Schlüssels, eines Werts und eines absoluten Ablaufwerts im Cache hinzu.
Contains(String, String)	Bestimmt, ob ein Cacheeintrag im Cache vorhanden ist.
CreateCacheEntryChangeMonitor(IEnumerable<String>, String)	Erstellt ein CacheEntryChangeMonitor-Objekt, das Ereignisse auslösen kann, wenn Änderungen an angegebenen Cacheeinträgen vorgenommen werden.
Dispose()	Gibt alle von der aktuellen Instanz der MemoryCache-Klasse verwendeten Ressourcen frei.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Get(String, String)	Gibt einen Eintrag aus dem Cache zurück.
GetCacheItem(String, String)	Gibt den angegebenen Eintrag als CacheItem-Instanz aus dem Cache zurück.
GetCount(String)	Gibt die Gesamtanzahl von Cacheeinträgen im Cache zurück.
GetEnumerator()	Erstellt einen Enumerator, der zum Durchlaufen einer Auflistung von Cacheeinträgen verwendet werden kann.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLastSize(String)	Ruft die Größe des benannten Bereichs ab.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValues(IEnumerable<String>, String)	Gibt einen Satz von Cacheeinträgen zurück, die den angegebenen Schlüsseln entsprechen.
GetValues(String, String[])	Ruft einen Satz von Cacheeinträgen ab, die den angegebenen Schlüsseln entsprechen. (Geerbt von ObjectCache)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(String, CacheEntryRemovedReason, String)	Entfernt mithilfe des Grunds einen Cacheeintrag aus dem Cache.
Remove(String, String)	Entfernt einen Cacheeintrag aus dem Cache.
Set(CacheItem, CacheItemPolicy)	Fügt einen Cacheeintrag in den Cache ein und gibt dabei mit einer CacheItem-Instanz den Schlüssel und den Wert für den Cacheeintrag an.
Set(String, Object, CacheItemPolicy, String)	Fügt einen Cacheeintrag unter Verwendung eines Schlüssels, eines Werts und von Entfernungsdetails in den Cache ein.
Set(String, Object, DateTimeOffset, String)	Fügt einen Cacheeintrag unter Verwendung eines Schlüssels und eines Werts in den Cache ein und gibt zeitbasierte Ablaufdetails an.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Trim(Int32)	Entfernt einen angegebenen Prozentsatz von Cacheeinträgen aus dem Cacheobjekt.

Explizite Schnittstellenimplementierungen

IEnumerable.GetEnumerator()	Stellt Unterstützung für eine Iteration durch eine generische Auflistung bereit.
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	Unterstützt die Iteration durch eine stark typisierte Auflistung. (Geerbt von ObjectCache)

Erweiterungsmethoden

Threadsicherheit

Dieser Typ ist threadsicher.

Weitere Informationen

• ObjectCache
• Exemplarische Vorgehensweise: Zwischenspeichern von Anwendungsdaten in ASP.NET
• Caching in .NET Framework-Anwendungen