MemoryCache.Set 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
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, 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.
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.

Megjegyzések

Ha a megadott bejegyzés nem létezik, létrejön. Ha a megadott bejegyzés létezik, az frissül.

Set(CacheItem, CacheItemPolicy)

Forrás:

MemoryCache.cs

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.

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

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

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

Public Overrides Sub Set (item As CacheItem, policy As CacheItemPolicy)

Paraméterek

item

CacheItem

Egy beszúrni kívánt gyorsítótárbejegyzést jelképező 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.

Kivételek

ArgumentNullException

item az null.

-vagy-

A Key tulajdonság null.

-vagy-

A Value tulajdonság null.

ArgumentException

A gyorsítótárbejegyzés argumentumainak érvénytelen kombinációja lett átadva. Ez akkor fordul elő, ha a gyorsítótár-bejegyzés szabályzatobjektumában a következő lejárati adatok vannak beállítva:

• Ha az objektum abszolút és csúszó 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 tudja beállítani a lejárati szabályzatot az abszolút lejárat és a csúszó lejárat 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ásnak vagy tulajdonságnak InfiniteAbsoluteExpirationNoSlidingExpiration kell lennie.

• Ha az eltávolítási visszahívás és a frissítés visszahívása is meg van adva az objektumhoz CacheItemPolicy . Az MemoryCache osztály csak 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-

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

-vagy-

Ez Priority nem az CacheItemPriority enumerálás értéke.

Megjegyzések

Más Set metódusok túlterheléséhez hasonlóan a Set metódus mindig gyorsítótárértéket helyez el a gyorsítótárban, függetlenül attól, hogy már létezik-e olyan bejegyzés, amely ugyanazzal a kulccsal rendelkezik. Ha a megadott bejegyzés nem található a gyorsítótárban, a rendszer új gyorsítótárbejegyzést szúr be. Ha a megadott bejegyzés már létezik, az értéke frissül.

Set(String, Object, DateTimeOffset, String)

Forrás:

MemoryCache.cs

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.

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

override this.Set : string * obj * DateTimeOffset * string -> unit

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

Paraméterek

key

String

A beszúrni kívánt gyorsítótárbejegyzé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.

Kivételek

NotSupportedException

regionName nem null.

ArgumentNullException

key az null.

-vagy-

value az null.

ArgumentException

• A gyorsítótárbejegyzés argumentumainak érvénytelen kombinációja lett átadva. Ez akkor fordul elő, ha a gyorsítótár-bejegyzés szabályzatobjektumában a következő lejárati adatok vannak beállítva:

• Ha az objektum abszolút és csúszó lejárati értékei CacheItemPolicy is az alapértelmezett InfiniteAbsoluteExpiration értékeken kívülre NoSlidingExpirationvannak állítva. Ez azért fordul elő, mert az osztály nem támogatja az MemoryCache abszolút és a csúszó lejárat alapján lejáró bejegyzéseket. 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.

• Ha az eltávolítási visszahívás és a frissítés visszahívása is meg van adva az objektumon CacheItemPolicy . Az MemoryCache osztály csak 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-

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

Más Set metódusok túlterheléséhez hasonlóan a Set metódus mindig gyorsítótárértéket helyez el a gyorsítótárban, függetlenül attól, hogy egy bejegyzés már létezik-e ugyanazzal a kulccsal. Ha a megadott bejegyzés nem létezik, a rendszer új gyorsítótárbejegyzést szúr be. Ha a megadott bejegyzés létezik, az frissül.

A absoluteExpiration paraméter azt jelzi, hogy mikor kell eltávolítani a bejegyzést a gyorsítótárból.

A bejegyzés eltávolítása minden társított változásfigyelőt aktivál. Ha az eltávolított elem objektumhoz CacheItemUpdateCallback vagy CacheItemRemovedCallback objektumhoz volt társítva, a visszahívásoknak átadott eltávolítás oka a Removed tulajdonságban található.

Set(String, Object, CacheItemPolicy, String)

Forrás:

MemoryCache.cs

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.

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

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

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

Paraméterek

key

String

A beszúrni kívánt gyorsítótárbejegyzé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.

Kivételek

ArgumentNullException

key az null.

-vagy-

value van null

-vagy-

A tulajdonság segédmetódusának átadott visszahívási hivatkozás a UpdateCallback következő null: .

ArgumentException

• A gyorsítótár-bejegyzés argumentumainak érvénytelen kombinációja létezik. Ez akkor fordul elő, ha a gyorsítótár-bejegyzés szabályzatobjektumában a következő lejárati adatok vannak beállítva:

• Ha az objektum abszolút és csúszó lejárati értékei CacheItemPolicy is az alapértelmezett InfiniteAbsoluteExpiration értékeken kívülre NoSlidingExpirationvannak állítva. Ennek az az oka, hogy az osztály nem támogatja a MemoryCache lejáró bejegyzéseket az abszolút és a csúszó lejárat 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.

• Ha az eltávolítási visszahívás és a frissítés visszahívása is meg van adva az osztályban CacheItemPolicy . Az MemoryCache osztály csak 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-

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

-vagy-

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

NotSupportedException

regionName nem null.

Megjegyzések

Más Set metódusok túlterheléséhez hasonlóan a Set metódus mindig gyorsítótárértéket helyez el a gyorsítótárban, függetlenül attól, hogy már létezik-e egyező bejegyzés. Ha a megadott bejegyzés nem található a gyorsítótárban, a rendszer új gyorsítótárbejegyzést szúr be. Ha a megadott bejegyzés létezik, az frissül.

A bejegyzés eltávolítása minden társított változásfigyelőt aktivál. Ha az eltávolított elem objektumhoz CacheItemUpdateCallback vagy CacheItemRemovedCallback objektumhoz volt társítva, a visszahívásoknak átadott eltávolítás oka a Removed tulajdonságban található.