ObjectCache.AddOrGetExisting Metoda

Definicja

Przestrzeń nazw:

System.Runtime.Caching

Zestaw:

System.Runtime.Caching.dll

Pakiet:

System.Runtime.Caching v9.0.0-rc.2.24473.5

Gdy zastąpisz klasę pochodną, próbuje wstawić wpis pamięci podręcznej do pamięci podręcznej i zwraca istniejący wpis pamięci podręcznej z pasującym kluczem.

Przeciążenia

AddOrGetExisting(CacheItem, CacheItemPolicy)	Podczas zastępowania w klasie pochodnej wstawia określony CacheItem obiekt do pamięci podręcznej, określając informacje o sposobie eksmitowania wpisu.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Po przesłonięciu w klasie pochodnej wstawia wpis pamięci podręcznej do pamięci podręcznej przy użyciu klucza, obiektu dla wpisu pamięci podręcznej, wartości wygaśnięcia bezwzględnego i opcjonalnego regionu do dodania pamięci podręcznej.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Po zastąpieniu w klasie pochodnej wstawia wpis pamięci podręcznej do pamięci podręcznej, określając klucz i wartość wpisu pamięci podręcznej oraz informacje o sposobie eksmitowania wpisu.

Uwagi

Metoda AddOrGetExisting przeciąża wstawianie wpisu do pamięci podręcznej. Jeśli wpis pamięci podręcznej z pasującym kluczem już istnieje, zwraca istniejący wpis. Wpis pamięci podręcznej może być obiektem CacheItem lub obiektem ogólnym.

Istnieje jedna różnica między AddOrGetExisting przeciążeniami a Add przeciążeniami. Gdy te przeciążone metody spróbują wstawić wpis pamięci podręcznej, jeśli zostanie znaleziony istniejący wpis z kluczem zgodnym z istniejącym wstawionym wpisem pamięci podręcznej, AddOrGetExisting przeciążenia zwracają istniejący wpis pamięci podręcznej. Przeciążenia Add nie.

AddOrGetExisting(CacheItem, CacheItemPolicy)

Źródło:

ObjectCache.cs

Podczas zastępowania w klasie pochodnej wstawia określony CacheItem obiekt do pamięci podręcznej, określając informacje o sposobie eksmitowania wpisu.

public:
 abstract System::Runtime::Caching::CacheItem ^ AddOrGetExisting(System::Runtime::Caching::CacheItem ^ value, System::Runtime::Caching::CacheItemPolicy ^ policy);

public abstract System.Runtime.Caching.CacheItem AddOrGetExisting (System.Runtime.Caching.CacheItem value, System.Runtime.Caching.CacheItemPolicy policy);

abstract member AddOrGetExisting : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> System.Runtime.Caching.CacheItem

Public MustOverride Function AddOrGetExisting (value As CacheItem, policy As CacheItemPolicy) As CacheItem

Parametry

value

CacheItem

Obiekt do wstawienia.

policy

CacheItemPolicy

Obiekt, który zawiera szczegóły eksmisji dla wpisu pamięci podręcznej. Ten obiekt zapewnia więcej opcji eksmisji niż proste bezwzględne wygaśnięcie.

Zwraca

CacheItem

Jeśli istnieje wpis pamięci podręcznej o tym samym kluczu, określony wpis pamięci podręcznej; w przeciwnym razie , null.

AddOrGetExisting(String, Object, DateTimeOffset, String)

Źródło:

ObjectCache.cs

Po przesłonięciu w klasie pochodnej wstawia wpis pamięci podręcznej do pamięci podręcznej przy użyciu klucza, obiektu dla wpisu pamięci podręcznej, wartości wygaśnięcia bezwzględnego i opcjonalnego regionu do dodania pamięci podręcznej.

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

abstract member AddOrGetExisting : string * obj * DateTimeOffset * string -> obj

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

Parametry

key

String

Unikatowy identyfikator wpisu pamięci podręcznej.

value

Object

Obiekt do wstawienia.

absoluteExpiration

DateTimeOffset

Stała data i godzina wygaśnięcia wpisu pamięci podręcznej.

regionName

String

Opcjonalny. Nazwany region w pamięci podręcznej, do którego można dodać wpis pamięci podręcznej, jeśli regiony są implementowane. Wartość domyślna opcjonalnego parametru to null.

Zwraca

Object

Jeśli istnieje wpis pamięci podręcznej o tym samym kluczu, wartość określonego wpisu pamięci podręcznej; w przeciwnym razie , null.

Uwagi

To AddOrGetExisting(String, Object, DateTimeOffset, String) przeciążenie metody zwraca wartość obiektu, a CacheItem nie obiekt.

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Źródło:

ObjectCache.cs

Po zastąpieniu w klasie pochodnej wstawia wpis pamięci podręcznej do pamięci podręcznej, określając klucz i wartość wpisu pamięci podręcznej oraz informacje o sposobie eksmitowania wpisu.

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

abstract member AddOrGetExisting : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> obj

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

Parametry

key

String

Unikatowy identyfikator wpisu pamięci podręcznej.

value

Object

Obiekt do wstawienia.

policy

CacheItemPolicy

Obiekt, który zawiera szczegóły eksmisji dla wpisu pamięci podręcznej. Ten obiekt zapewnia więcej opcji eksmisji niż proste bezwzględne wygaśnięcie.

regionName

String

Opcjonalny. Nazwany region w pamięci podręcznej, do którego można dodać wpis pamięci podręcznej, jeśli regiony są implementowane. Wartość domyślna opcjonalnego parametru to null.

Zwraca

Object

Jeśli istnieje wpis pamięci podręcznej o tym samym kluczu, wartość określonego wpisu pamięci podręcznej; w przeciwnym razie , null.

Uwagi

Metoda AddOrGetExisting(String, Object, CacheItemPolicy, String) zwraca wartość obiektu, a CacheItem nie obiekt.