MemoryCache Osztály

Definíció

Névtér:

System.Runtime.Caching

Szerelvény:

System.Runtime.Caching.dll

Csomag:

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

Forrás:

MemoryCache.cs

A memóriabeli gyorsítótárat megvalósító típust jelöli.

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

Öröklődés

Object

ObjectCache

MemoryCache

Megvalósítás

IEnumerable IDisposable

Példák

Az alábbi példa az alapértelmezett memóriagyorsítótár-példányra mutató hivatkozást deklarál. A gyorsítótár-bejegyzés objektummal CacheItemPolicy adja meg a gyorsítótárbejegyzés kiürítési és lejárati adatait. Egy objektumot ChangeMonitor is használ a fájlrendszer forrásadatainak (vagyis fájljainak) állapotának figyeléséhez.

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

Megjegyzések

Az MemoryCache osztály az absztrakt ObjectCache osztály konkrét implementációja.

Note

A MemoryCache osztály hasonló a ASP.NET Cache osztályhoz. A MemoryCache osztály számos tulajdonsággal és metódussal rendelkezik a gyorsítótár eléréséhez, amelyek ismerősek lesznek, ha a ASP.NET Cache osztályt használta. A Cache és a MemoryCache osztály közötti fő különbség az, hogy a MemoryCache osztályt úgy módosították, hogy az .NET-keretrendszer olyan alkalmazásai számára is használható legyen, amelyek nem ASP.NET alkalmazások. Az osztálynak például MemoryCache nincs függősége a System.Web szerelvényhez. A másik különbség az, hogy az osztály több példányát MemoryCache is létrehozhatja, hogy ugyanabban az alkalmazásban és ugyanabban AppDomain a példányban is használható legyen.

Az MemoryCache osztály nem engedélyezi null értékként a gyorsítótárban. A gyorsítótár-bejegyzés hozzáadására vagy módosítására tett kísérletek sikertelenek lesznek null .

A MemoryCache típus nem implementálja a gyorsítótár-régiókat. Ezért amikor olyan metódusokat hív MemoryCache meg, amelyek régiók paraméterét tartalmazó alapmetodusokat implementálnak, ne adja át a paraméter értékét. A régióparamétert használó metódusok mindegyike alapértelmezett null értéket ad meg. A metódus túlterhelése például olyan MemoryCache.AddOrGetExisting paraméterrel rendelkezik, regionName amelynek alapértelmezett értéke .null

Konstruktorok

Name	Description
MemoryCache(String, NameValueCollection, Boolean)	Inicializálja a MemoryCache osztály új példányát.
MemoryCache(String, NameValueCollection)	Inicializálja a MemoryCache osztály új példányát.

Tulajdonságok

Name	Description
CacheMemoryLimit	Bájtban lekéri a számítógépen a gyorsítótár által használható memória mennyiségét.
Default	Az alapértelmezett MemoryCache példányra mutató hivatkozást kap.
DefaultCacheCapabilities	Lekéri a gyorsítótár által biztosított funkciók leírását.
Item[String]	Beolvas vagy beállít egy értéket a gyorsítótárban az osztály egy példányának alapértelmezett indexelő tulajdonságával MemoryCache .
Name	Lekéri a gyorsítótár nevét.
PhysicalMemoryLimit	Lekéri a rendszer fizikai memóriahasználatának százalékos arányát, amelynél a gyorsítótár megkezdi a bejegyzések kiürítését.
PollingInterval	Azt a maximális időt kapja meg, amely után a gyorsítótár frissíti a memóriastatisztikáit.

Metódusok

Name	Description
Add(CacheItem, CacheItemPolicy)	Egy gyorsítótárbejegyzést szúr be példányként CacheItem a gyorsítótárba, és részletes információkat ad a bejegyzés kizárásának módjáról.
Add(String, Object, CacheItemPolicy, String)	Ha egy származtatott osztályban felül van bírálva, egy gyorsítótárbejegyzést szúr be a gyorsítótárba, és megadja a bejegyzés kiürítésével kapcsolatos információkat. (Öröklődés forrása ObjectCache)
Add(String, Object, DateTimeOffset, String)	Ha egy származtatott osztályban felül van bírálva, a gyorsítótár-bejegyzést a meglévő gyorsítótárbejegyzés felülírása nélkül szúrja be a gyorsítótárba. (Öröklődés forrása ObjectCache)
AddOrGetExisting(CacheItem, CacheItemPolicy)	Hozzáad egy gyorsítótárbejegyzést a gyorsítótárhoz a megadott CacheItem példány használatával, valamint a bejegyzés kiürítésére vonatkozó részletekkel.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Gyorsítótárbejegyzés beszúrása a gyorsítótárba a megadott kulccsal és értékkel, valamint a kiürítés módjának megadott részleteivel.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Hozzáad egy gyorsítótárbejegyzést a gyorsítótárhoz a megadott kulccsal, egy értékkel és egy abszolút lejárati értékkel.
Contains(String, String)	Meghatározza, hogy létezik-e gyorsítótárbejegyzés a gyorsítótárban.
CreateCacheEntryChangeMonitor(IEnumerable<String>, String)	Létrehoz egy CacheEntryChangeMonitor objektumot, amely eseményeket indíthat el a megadott gyorsítótár-bejegyzések változásaira válaszul.
Dispose()	Az osztály aktuális példánya által használt összes erőforrást felszabadítja MemoryCache .
Get(String, String)	Egy bejegyzést ad vissza a gyorsítótárból.
GetCacheItem(String, String)	A megadott bejegyzést adja vissza a gyorsítótárból példányként CacheItem .
GetCount(String)	A gyorsítótárban lévő gyorsítótár-bejegyzések teljes számát adja vissza.
GetEnumerator()	Létrehoz egy enumerátort, amely gyorsítótárbejegyzések gyűjteményén keresztüli iterálásra használható.
GetLastSize(String)	Lekéri a megnevezett régió méretét.
GetValues(IEnumerable<String>, String)	A megadott kulcsoknak megfelelő gyorsítótárbejegyzéseket ad vissza.
GetValues(String, String[])	Lekéri a megadott kulcsoknak megfelelő gyorsítótárbejegyzéseket. (Öröklődés forrása ObjectCache)
Remove(String, CacheEntryRemovedReason, String)	Az ok használatával eltávolít egy gyorsítótárbejegyzést a gyorsítótárból.
Remove(String, String)	Eltávolít egy gyorsítótárbejegyzést a gyorsítótárból.
Set(CacheItem, CacheItemPolicy)	Gyorsítótárbejegyzés beszúrása a gyorsítótárba egy CacheItem példány használatával a gyorsítótárbejegyzés kulcsának és értékének megadásához.
Set(String, Object, CacheItemPolicy, String)	Gyorsítótárbejegyzés beszúrása a gyorsítótárba egy kulcs, egy érték és egy kiürítés használatával.
Set(String, Object, DateTimeOffset, String)	Egy gyorsítótárbejegyzést szúr be a gyorsítótárba egy kulcs és egy érték használatával, és megadja az időalapú lejárat részleteit.
Trim(Int32)	Eltávolítja a gyorsítótár-bejegyzések meghatározott százalékát a gyorsítótár-objektumból.

Explicit interfész-implementációk

Name	Description
IEnumerable.GetEnumerator()	Támogatja az általános gyűjtemények iterációját.
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	Támogatja az iterációt egy erősen gépelt gyűjteményen keresztül. (Öröklődés forrása ObjectCache)

Bővítő metódusok

Name	Description
ToAsyncEnumerable<TSource>(IEnumerable<TSource>)	Átalakítja az egyiket IEnumerable<T>IAsyncEnumerable<T>.
ToFrozenDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Létrehoz egy FrozenDictionary<TKey,TValue>IEnumerable<T> megadott kulcsválasztó és elemválasztó függvény alapján.
ToFrozenDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Létrehoz egy FrozenDictionary<TKey,TValue> megadott kulcsválasztó függvényt IEnumerable<T> .
ToFrozenSet<T>(IEnumerable<T>, IEqualityComparer<T>)	Létrehoz egy FrozenSet<T> értéket a megadott értékekkel.
ToImmutableArray<TSource>(IEnumerable<TSource>)	Módosíthatatlan tömböt hoz létre a megadott gyűjteményből.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>, IEqualityComparer<TValue>)	Számba és átalakít egy sorozatot, és a megadott kulcs- és érték-összehasonlítók használatával módosíthatatlan szótárt hoz létre a tartalmából.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>)	Számba és átalakít egy sorozatot, és a megadott kulcs-összehasonlító használatával módosíthatatlan szótárt hoz létre a tartalmából.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Számbavétele és átalakítása egy sorozat, és létrehoz egy nem módosítható szótár a tartalmát.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Egy szekvencia valamilyen átalakításán alapuló nem módosítható szótárt hoz létre.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Egy nem módosítható szótárat hoz létre egy meglévő elemgyűjteményből, amely egy átalakítási függvényt alkalmaz a forráskulcsokra.
ToImmutableHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Számba veszi a sorozatot, módosíthatatlan kivonatkészletet hoz létre a tartalmából, és a megadott egyenlőség-összehasonlítót használja a készlettípushoz.
ToImmutableHashSet<TSource>(IEnumerable<TSource>)	Számba ad egy sorozatot, és a tartalma nem módosítható kivonatkészletet hoz létre.
ToImmutableList<TSource>(IEnumerable<TSource>)	Számba ad egy sorozatot, és megváltoztathatatlan listát hoz létre annak tartalmáról.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>, IEqualityComparer<TValue>)	Számba és átalakít egy sorozatot, és a megadott kulcs- és érték-összehasonlítók használatával módosíthatatlan rendezési szótárt hoz létre a tartalmaiból.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>)	Számbavesz és átalakít egy sorozatot, és a megadott kulcs-összehasonlító használatával módosíthatatlan rendezési szótárt hoz létre a tartalmaiból.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Számbavétele és átalakítása egy sorozat, és létrehoz egy nem módosítható rendezett szótár a tartalmát.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>, IComparer<TSource>)	Számba veszi a sorozatot, megváltoztathatatlan rendezési halmazt hoz létre, és a megadott összehasonlítót használja.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>)	Számba ad egy sorozatot, és megváltoztathatatlan rendezésű halmazt hoz létre annak tartalmából.

Szálbiztonság

Ez a típus szálbiztos.

Lásd még

• ObjectCache
• Bemutató: Alkalmazásadatok gyorsítótárazása az ASP.NET
• Gyorsítótárazás a .NET keretrendszer alkalmazásaiban