ObjectCache.Add 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

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 anélkül, hogy egy meglévő, egyező kulccsal rendelkező gyorsítótárbejegyzést kellene visszaadni.

Túlterhelések

Name	Description
Add(CacheItem, CacheItemPolicy)	Ha felül van bírálva egy származtatott osztályban, megpróbál gyorsítótárbejegyzést beszúrni a gyorsítótárba példányként CacheItem , és részletes információkat ad a bejegyzés kizárásának módjáról.
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.
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.

Megjegyzések

A Add metódus túlterhelései megpróbálnak gyorsítótárbejegyzést beszúrni a gyorsítótárba anélkül, hogy felülírják vagy eltávolítanák az azonos kulccsal rendelkező meglévő gyorsítótár-bejegyzést. A gyorsítótár-bejegyzés lehet gépelt CacheItem objektum vagy általános objektum.

A AddOrGetExisting metódus túlterhelése és a Add metódus túlterhelése jelentős különbséget jelent. Amikor ezek a metódusok gyorsítótárbejegyzést szúrnak be, ha egyező bejegyzés található a gyorsítótárban, a AddOrGetExisting metódus túlterhelése visszaadja a meglévő gyorsítótár-bejegyzést, de a Add metódus túlterhelése nem történik meg. A különböző metódusok túlterhelése lehetővé teszi a hívók számára a kód optimalizálását annak alapján, hogy szükség van-e a meglévő gyorsítótár-bejegyzésre. Elosztott gyorsítótárakban egy meglévő érték metódussal AddOrGetExisting történő visszaadása drágább lehet, mint egy logikai érték metódussal Add történő visszaadása.

Add(CacheItem, CacheItemPolicy)

Forrás:

ObjectCache.cs

Ha felül van bírálva egy származtatott osztályban, megpróbál gyorsítótárbejegyzést beszúrni a gyorsítótárba példányként CacheItem , és részletes információkat ad a bejegyzés kizárásának módjáról.

public:
 virtual bool Add(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public virtual bool Add(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

abstract member Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
override this.Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool

Public Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean

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

Boolean

true ha a beszúrás sikeres volt, vagy false ha már van olyan bejegyzés a gyorsítótárban, amely ugyanazzal a kulccsal rendelkezik, mint itema .

Megjegyzések

A Add metódus túlterhelései virtuálisak (nem absztraktak) az ObjectCache osztályon, mivel a Add metódus belsőleg hív.AddOrGetExisting Ez csökkenti a gyorsítótár-implementátor által biztosított metódusterhelések számát. Ha a gyorsítótár-implementáció nem igényel különleges viselkedést a Add metódushoz, egyszerűen megvalósíthatja a AddOrGetExisting metódus túlterhelését.

Add(String, Object, DateTimeOffset, String)

Forrás:

ObjectCache.cs

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.

public virtual bool Add(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

abstract member Add : string * obj * DateTimeOffset * string -> bool
override this.Add : string * obj * DateTimeOffset * string -> bool

Public Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Boolean

Paraméterek

key

String

A gyorsítótár-bejegyzés egyedi azonosítója.

value

Object

A beszúrni kívánt objektum.

absoluteExpiration

DateTimeOffset

A gyorsítótár-bejegyzés lejáratának rögzített dátuma és időpontja. Ez a paraméter a metódus meghívásakor Add szükséges.

regionName

String

Optional. Egy elnevezett régió a gyorsítótárban, amelyhez a gyorsítótárbejegyzés hozzáadható, ha a régiók implementálva vannak. Mivel a régiók nincsenek implementálva a 4. keretrendszerben .NET, az alapértelmezett érték null.

Válaszok

Boolean

true ha a beszúrás sikeres volt, vagy false ha már van olyan bejegyzés a gyorsítótárban, amely ugyanazzal a kulccsal rendelkezik, mint keya .

Megjegyzések

A Add metódus túlterhelései virtuálisak (nem absztraktak) az ObjectCache osztályon, mivel a Add metódus belsőleg hív.AddOrGetExisting Ez csökkenti a gyorsítótár-implementátor által biztosított metódusterhelések számát. Ha a gyorsítótár-implementáció nem igényel különleges viselkedést a Add metódushoz, egyszerűen megvalósíthatja a AddOrGetExisting metódus túlterhelését.

Add(String, Object, CacheItemPolicy, String)

Forrás:

ObjectCache.cs

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.

public virtual bool Add(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

abstract member Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
override this.Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool

Public Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Boolean

Paraméterek

key

String

A gyorsítótár-bejegyzés egyedi azonosítója.

value

Object

A beszúrni 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.

regionName

String

Optional. Egy elnevezett régió a gyorsítótárban, amelyhez a gyorsítótárbejegyzés hozzáadható, ha a régiók implementálva vannak. Az opcionális paraméter alapértelmezett értéke a következő null.

Válaszok

Boolean

true ha a beszúrás sikeres, vagy false ha már van egy bejegyzés a gyorsítótárban ugyanazzal a kulccsal, mint keya .

Megjegyzések

A Add metódus túlterhelései virtuálisak (nem absztraktak) az ObjectCache osztályon, mivel a Add metódus belsőleg hív.AddOrGetExisting Ez csökkenti a gyorsítótár-implementátor által biztosított metódusterhelések számát. Ha a gyorsítótár-implementáció nem igényel különleges viselkedést a Add metódushoz, egyszerűen megvalósíthatja a AddOrGetExisting metódus túlterhelését.