MemoryCache Třída

Definice

Obor názvů:

System.Runtime.Caching

Sestavení:

System.Runtime.Caching.dll

Balíček:

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

Zdroj:

MemoryCache.cs

Představuje typ, který implementuje mezipaměť v paměti.

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

Dědičnost

Object

ObjectCache

MemoryCache

Implementuje

IEnumerable IDisposable

Příklady

Následující příklad deklaruje odkaz na výchozí instanci mezipaměti paměti. Položka mezipaměti používá CacheItemPolicy objekt k zadání vyřazování a podrobností o vypršení platnosti položky mezipaměti. Používá ChangeMonitor také objekt ke sledování stavu zdrojových dat (což je soubor) v systému souborů.

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

Poznámky

Třída MemoryCache je konkrétní implementace abstraktní ObjectCache třídy.

Poznámka

Třída MemoryCache je podobná třídě ASP.NET Cache. Třída MemoryCache má mnoho vlastností a metod pro přístup k mezipaměti, které vám budou známé, pokud jste použili třídu ASP.NET Cache. Hlavní rozdíly mezi třídami Cache a MemoryCache jsou, že třída MemoryCache byla změněna tak, aby ji bylo možné použít aplikacemi .NET Framework, které nejsou ASP.NET aplikacemi. Třída například MemoryCache nemá žádné závislosti na System.Web sestavení. Dalším rozdílem je, že můžete vytvořit více instancí MemoryCache třídy pro použití ve stejné aplikaci a ve stejné AppDomain instanci.

Třída MemoryCache neumožňuje null jako hodnotu v mezipaměti. Všechny pokusy o přidání nebo změnu položky mezipaměti s hodnotou null selžou.

Typ MemoryCache neimplementuje oblasti mezipaměti. Proto při volání MemoryCache metod, které implementují základní metody, které obsahují parametr pro oblasti, nepředávejte hodnotu parametru. Metody, které používají parametr oblasti, všechny poskytují výchozí null hodnotu. Například přetížení metody má parametr, MemoryCache.AddOrGetExisting jehož výchozí hodnota je null.regionName

Konstruktory

Name	Description
MemoryCache(String, NameValueCollection, Boolean)	Inicializuje novou instanci MemoryCache třídy.
MemoryCache(String, NameValueCollection)	Inicializuje novou instanci MemoryCache třídy.

Vlastnosti

Name	Description
CacheMemoryLimit	Získá množství paměti v počítači v bajtech, které lze použít v mezipaměti.
Default	Získá odkaz na výchozí MemoryCache instanci.
DefaultCacheCapabilities	Získá popis funkcí, které mezipaměť poskytuje.
Item[String]	Získá nebo nastaví hodnotu v mezipaměti pomocí výchozí indexer vlastnost instance MemoryCache třídy.
Name	Získá název mezipaměti.
PhysicalMemoryLimit	Získá procento celkového využití fyzické paměti systému, při kterém mezipaměť začne vyřazovat položky.
PollingInterval	Získá maximální dobu, po které mezipaměť aktualizuje statistiku paměti.

Metody

Name	Description
Add(CacheItem, CacheItemPolicy)	Vloží položku mezipaměti do mezipaměti jako CacheItem instanci a přidá podrobnosti o tom, jak má být položka vyřazena.
Add(String, Object, CacheItemPolicy, String)	Při přepsání v odvozené třídě vloží položku mezipaměti do mezipaměti a určuje informace o tom, jak bude položka vyřazena. (Zděděno od ObjectCache)
Add(String, Object, DateTimeOffset, String)	Při přepsání v odvozené třídě vloží položku mezipaměti do mezipaměti bez přepsání jakékoli existující položky mezipaměti. (Zděděno od ObjectCache)
AddOrGetExisting(CacheItem, CacheItemPolicy)	Přidá položku mezipaměti do mezipaměti pomocí zadané CacheItem instance a podrobnosti o tom, jak položku vyřadit.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Vloží položku mezipaměti do mezipaměti pomocí zadaného klíče a hodnoty a zadaných podrobností o tom, jak se má vyřadit.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Přidá položku mezipaměti do mezipaměti pomocí zadaného klíče a hodnoty a absolutní hodnoty vypršení platnosti.
Contains(String, String)	Určuje, zda položka mezipaměti existuje v mezipaměti.
CreateCacheEntryChangeMonitor(IEnumerable<String>, String)	Vytvoří CacheEntryChangeMonitor objekt, který může aktivovat události v reakci na změny zadaných položek mezipaměti.
Dispose()	Uvolní všechny prostředky, které používají aktuální instance MemoryCache třídy.
Get(String, String)	Vrátí položku z mezipaměti.
GetCacheItem(String, String)	Vrátí zadanou CacheItem položku z mezipaměti jako instanci.
GetCount(String)	Vrátí celkový počet položek mezipaměti v mezipaměti.
GetEnumerator()	Vytvoří enumerátor, který lze použít k iteraci prostřednictvím kolekce položek mezipaměti.
GetLastSize(String)	Získá velikost pojmenované oblasti.
GetValues(IEnumerable<String>, String)	Vrátí sadu položek mezipaměti, které odpovídají zadaným klíčům.
GetValues(String, String[])	Získá sadu položek mezipaměti, které odpovídají zadaným klíčům. (Zděděno od ObjectCache)
Remove(String, CacheEntryRemovedReason, String)	Odebere položku mezipaměti z mezipaměti pomocí důvodu.
Remove(String, String)	Odebere položku mezipaměti z mezipaměti.
Set(CacheItem, CacheItemPolicy)	Vloží položku mezipaměti do mezipaměti pomocí CacheItem instance k zadání klíče a hodnoty pro položku mezipaměti.
Set(String, Object, CacheItemPolicy, String)	Vloží položku mezipaměti do mezipaměti pomocí klíče a hodnoty a vyřazení.
Set(String, Object, DateTimeOffset, String)	Vloží položku mezipaměti do mezipaměti pomocí klíče a hodnoty a určuje podrobnosti o vypršení platnosti na základě času.
Trim(Int32)	Odebere zadané procento položek mezipaměti z objektu mezipaměti.

Explicitní implementace rozhraní

Name	Description
IEnumerable.GetEnumerator()	Poskytuje podporu iterace v obecné kolekci.
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	Podporuje iteraci nad kolekcí se silnými typy. (Zděděno od ObjectCache)

Metody rozšíření

Name	Description
ToAsyncEnumerable<TSource>(IEnumerable<TSource>)	Vytvoří novou IAsyncEnumerable<T> iterací .source
ToFrozenDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Vytvoří FrozenDictionary<TKey,TValue> z IEnumerable<T> podle zadaných funkcí selektoru klíčů a selektoru prvků.
ToFrozenDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	FrozenDictionary<TKey,TValue> Vytvoří z funkce selektoru klíčů podle zadané funkce selektoru IEnumerable<T> klíčů.
ToFrozenSet<T>(IEnumerable<T>, IEqualityComparer<T>)	Vytvoří se FrozenSet<T> zadanými hodnotami.
ToImmutableArray<TSource>(IEnumerable<TSource>)	Vytvoří neměnné pole ze zadané kolekce.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>, IEqualityComparer<TValue>)	Vytvoří výčet a transformaci sekvence a vytvoří neměnný slovník jeho obsahu pomocí zadaných porovnávacích klíčů a hodnot.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>)	Vytvoří výčet a transformaci sekvence a vytvoří neměnný slovník jeho obsahu pomocí zadaného porovnávače klíčů.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Vytvoří výčet a transformaci sekvence a vytvoří neměnný slovník jeho obsahu.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Vytvoří neměnný slovník na základě určité transformace sekvence.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Vytvoří neměnný slovník z existující kolekce prvků a použije transformační funkci na zdrojové klíče.
ToImmutableHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Vytvoří výčet sekvence, vytvoří neměnnou sadu hodnot hash jejího obsahu a použije zadaný porovnávač rovnosti pro typ sady.
ToImmutableHashSet<TSource>(IEnumerable<TSource>)	Vytvoří výčet sekvence a vytvoří neměnnou sadu hodnot hash jejího obsahu.
ToImmutableList<TSource>(IEnumerable<TSource>)	Vytvoří výčet sekvence a vytvoří neměnný seznam jeho obsahu.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>, IEqualityComparer<TValue>)	Vytvoří výčet a transformaci sekvence a vytvoří neměnný seřazený slovník jeho obsahu pomocí zadaných porovnávacích klíčů a hodnot.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>)	Vytvoří výčet a transformaci sekvence a vytvoří neměnný seřazený slovník jeho obsahu pomocí zadaného porovnávače klíčů.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Vytvoří výčet a transformaci sekvence a vytvoří neměnný seřazený slovník jeho obsahu.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>, IComparer<TSource>)	Vytvoří výčet sekvence, vytvoří neměnnou seřazenou sadu jejího obsahu a použije zadaný porovnávač.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>)	Vytvoří výčet sekvence a vytvoří neměnnou seřazenou sadu jejího obsahu.

Bezpečný přístup z více vláken

Tento typ je bezpečný pro přístup z více vláken.

Viz také

• ObjectCache
• Caching v .NET Framework Applications