MemoryCache.AddOrGetExisting Metódus

Definíció

Névtér:

System.Runtime.Caching

Szerelvény:

System.Runtime.Caching.dll

Csomag:

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

Gyorsítótárbejegyzés beszúrása a gyorsítótárba.

Túlterhelések

Name	Description
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, 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.
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.

Megjegyzések

A AddOrGetExisting metódus túlterheltségekkel szúr be egy gyorsítótárbejegyzést a gyorsítótárba. Ha nem létezik egy egyező kulccsal rendelkező gyorsítótárbejegyzés, ezek a metódusok új bejegyzést szúrnak be. Ha már létezik egy egyező kulccsal rendelkező gyorsítótárbejegyzés, a meglévő bejegyzést adja vissza.

AddOrGetExisting(CacheItem, CacheItemPolicy)

Forrás:

MemoryCache.cs

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.

public:
 override System::Runtime::Caching::CacheItem ^ AddOrGetExisting(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public override System.Runtime.Caching.CacheItem AddOrGetExisting(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

override this.AddOrGetExisting : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> System.Runtime.Caching.CacheItem

Public Overrides Function AddOrGetExisting (item As CacheItem, policy As CacheItemPolicy) As CacheItem

Paraméterek

item

CacheItem

A hozzáadni kívánt objektum.

policy

CacheItemPolicy

Egy objektum, amely a gyorsítótár-bejegyzés kiürítési adatait tartalmazza. Ez az objektum több lehetőséget kínál a kizárásra, mint egy egyszerű abszolút lejárat.

Válaszok

CacheItem

Ha ugyanazzal a kulccsal rendelkező gyorsítótárbejegyzés létezik, a meglévő gyorsítótár-bejegyzés; egyéb esetben. null

Kivételek

ArgumentNullException

A Value tulajdonság null.

ArgumentException

Az objektum abszolút és csúsztatásos lejárati CacheItemPolicy értékei is az alapértelmezett InfiniteAbsoluteExpiration értékeken és NoSlidingExpiration mezőkön kívüli értékekre vannak beállítva. Az MemoryCache osztály nem állíthatja be a lejárati szabályzatot az abszolút lejárat és a csúszó lejárat kombinációja alapján. A példány használatakor csak egy lejárati MemoryCache beállítás állítható be explicit módon. A másik lejárati beállítást mezőre vagy InfiniteAbsoluteExpiration mezőre NoSlidingExpiration kell állítani.

ArgumentOutOfRangeException

A SlidingExpiration tulajdonság értéke kisebb, mint Zero.

-vagy-

A SlidingExpiration tulajdonság értéke egy évnél nagyobb.

-vagy-

A Priority tulajdonság nem az CacheItemPriority enumerálás értéke.

Megjegyzések

A item paraméter a metódus által használt kulcsot és értéket adja meg. Ha a gyorsítótár gyorsítótár-bejegyzése ugyanazzal a kulccsal rendelkezik, mint a item paraméter kulcsa, a metódus példányként adja vissza a meglévő bejegyzést CacheItem . Ha nincs meglévő gyorsítótárbejegyzés, a metódus létrehoz egy újat a paraméter által item megadott kulccsal és értékkel, valamint a megadott kiürítési adatokkal policy.

Warning

A Add metódus túlterhelése AddOrGetExisting nem támogatja a tulajdonságot UpdateCallback . Ezért a gyorsítótár-bejegyzés tulajdonságának UpdateCallback beállításához használja inkább a Set metódus túlterhelését.

AddOrGetExisting(String, Object, DateTimeOffset, String)

Forrás:

MemoryCache.cs

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.

public override object AddOrGetExisting(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

override this.AddOrGetExisting : string * obj * DateTimeOffset * string -> obj

Public Overrides Function AddOrGetExisting (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Object

Paraméterek

key

String

A hozzáadni kívánt gyorsítótár-bejegyzés egyedi azonosítója.

value

Object

A gyorsítótár-bejegyzés adatai.

absoluteExpiration

DateTimeOffset

A gyorsítótár-bejegyzés lejáratának rögzített dátuma és időpontja.

regionName

String

Egy elnevezett régió a gyorsítótárban, amelyhez gyorsítótárbejegyzés adható hozzá. Ne adjon meg értéket ehhez a paraméterhez. Ez a paraméter alapértelmezés szerint azért van null , mert az MemoryCache osztály nem implementál régiókat.

Válaszok

Object

Ha ugyanazzal a kulccsal rendelkező gyorsítótárbejegyzés létezik, a meglévő gyorsítótár-bejegyzés; egyéb esetben. null

Kivételek

ArgumentNullException

value nem null.

NotSupportedException

regionName nem null.

ArgumentException

Az objektum abszolút és csúsztatásos lejárati CacheItemPolicy értékei is az alapértelmezett InfiniteAbsoluteExpiration értékeken és NoSlidingExpiration mezőkön kívüli értékekre vannak beállítva. Az MemoryCache osztály nem állíthatja be a lejárati szabályzatot az abszolút lejárat és a csúszó lejárat kombinációja alapján. A példány használatakor csak egy lejárati MemoryCache beállítás állítható be explicit módon. A másik lejárati beállítást a következőre kell beállítani:InfiniteAbsoluteExpirationNoSlidingExpiration

ArgumentOutOfRangeException

A SlidingExpiration tulajdonság értéke kisebb, mint Zero.

-vagy-

A SlidingExpiration tulajdonság értéke egy évnél nagyobb.

-vagy-

A Priority tulajdonság nem az CacheItemPriority enumerálás értéke.

Megjegyzések

Ha a gyorsítótár nem rendelkezik olyan gyorsítótárbejegyzéssel, amelynek kulcsa megegyezik a key paraméterrel, létrejön egy új gyorsítótárbejegyzés, és a MemoryCache.AddOrGetExisting metódus túlterhelése nullvisszatér. Ha létezik egyező gyorsítótárbejegyzés, a meglévő bejegyzés lesz visszaadva.

Warning

A Add metódus túlterhelése AddOrGetExisting nem támogatja a tulajdonságot UpdateCallback . Ezért a gyorsítótár-bejegyzés tulajdonságának UpdateCallback beállításához használja inkább a Set metódus túlterhelését.

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Forrás:

MemoryCache.cs

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.

public override object AddOrGetExisting(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

override this.AddOrGetExisting : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> obj

Public Overrides Function AddOrGetExisting (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Object

Paraméterek

key

String

A hozzáadni vagy lekérni kívánt gyorsítótár-bejegyzés egyedi azonosítója.

value

Object

A gyorsítótár-bejegyzés adatai.

policy

CacheItemPolicy

Egy objektum, amely a gyorsítótár-bejegyzés kiürítési adatait tartalmazza. Ez az objektum több lehetőséget kínál a kizárásra, mint egy egyszerű abszolút lejárat.

regionName

String

Egy elnevezett régió a gyorsítótárban, amelyhez gyorsítótárbejegyzés adható hozzá. Ne adjon meg értéket ehhez a paraméterhez. Ez a paraméter alapértelmezés szerint azért van null, mert az MemoryCache osztály nem implementál régiókat.

Válaszok

Object

Ha már létezik egy egyező gyorsítótárbejegyzés, egy gyorsítótárbejegyzés; egyéb esetben. null

Kivételek

ArgumentNullException

value az null.

ArgumentException

Az objektum abszolút és csúsztatásos lejárati CacheItemPolicy értékei is az alapértelmezett InfiniteAbsoluteExpiration értékeken kívülre NoSlidingExpirationvannak állítva. Az MemoryCache osztály nem állíthatja be a lejárati szabályzatot az abszolút és a csúszó lejárat kombinációja alapján. Az osztály használatakor csak egy lejárati MemoryCache beállítás állítható be explicit módon. A másik beállítást a következő értékre kell állítani: InfiniteAbsoluteExpiration vagy NoSlidingExpiration.

-vagy-

Az eltávolítási visszahívás és a frissítési visszahívás is meg lett adva a következőhöz CacheItemPolicy: . Csak MemoryCache egy típusú visszahívást támogat gyorsítótár-bejegyzésenként.

ArgumentOutOfRangeException

A SlidingExpiration tulajdonság értéke kisebb, mint Zero.

-vagy-

Az SlidingExpiration érték egy évnél nagyobb értékre lett beállítva.

-vagy-

A Priority tulajdonság nem az CacheItemPriority enumerálás értéke.

Megjegyzések

Warning

A Add metódus túlterhelése AddOrGetExisting nem támogatja a tulajdonságot UpdateCallback . Ezért a gyorsítótár-bejegyzés tulajdonságának UpdateCallback beállításához használja inkább a Set metódus túlterhelését.