MemoryCache.AddOrGetExisting Metoda

Definicja

Przestrzeń nazw:

System.Runtime.Caching

Zestaw:

System.Runtime.Caching.dll

Pakiet:

System.Runtime.Caching v9.0.0

Wstawia wpis pamięci podręcznej do pamięci podręcznej.

Przeciążenia

AddOrGetExisting(CacheItem, CacheItemPolicy)	Dodaje wpis pamięci podręcznej do pamięci podręcznej przy użyciu określonego CacheItem wystąpienia i szczegóły dotyczące eksmisji wpisu.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Dodaje wpis pamięci podręcznej do pamięci podręcznej przy użyciu określonego klucza i wartości oraz bezwzględnej wartości wygaśnięcia.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Wstawia wpis pamięci podręcznej do pamięci podręcznej przy użyciu określonego klucza i wartości oraz określone szczegóły dotyczące sposobu eksmitowania.

Uwagi

Przeciążenia AddOrGetExisting metody służą do wstawiania wpisu pamięci podręcznej do pamięci podręcznej. Jeśli wpis pamięci podręcznej z pasującym kluczem nie istnieje, te metody wstawią nowy wpis. Jeśli wpis pamięci podręcznej z pasującym kluczem już istnieje, zwraca istniejący wpis.

AddOrGetExisting(CacheItem, CacheItemPolicy)

Źródło:

MemoryCache.cs

Dodaje wpis pamięci podręcznej do pamięci podręcznej przy użyciu określonego CacheItem wystąpienia i szczegóły dotyczące eksmisji wpisu.

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

Parametry

item

CacheItem

Obiekt do dodania.

policy

CacheItemPolicy

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

Zwraca

CacheItem

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

Wyjątki

ArgumentNullException

Właściwość Value to null.

ArgumentException

Wartości wygasania bezwzględnego i przesuwanego obiektu CacheItemPolicy są ustawione na wartości inne niż wartości domyślne InfiniteAbsoluteExpiration i NoSlidingExpiration pola. Klasa MemoryCache nie może ustawić zasad wygasania na podstawie kombinacji bezwzględnego wygaśnięcia i przesuwanego wygaśnięcia. Tylko jedno ustawienie wygasania można jawnie ustawić podczas korzystania z MemoryCache wystąpienia. Inne ustawienie wygasania musi być ustawione na InfiniteAbsoluteExpiration pole lub NoSlidingExpiration pole.

ArgumentOutOfRangeException

Właściwość jest ustawiona SlidingExpiration na wartość mniejszą niż Zero.

-lub-

Właściwość SlidingExpiration jest ustawiona na wartość większą niż jeden rok.

-lub-

Właściwość Priority nie jest wartością wyliczenia CacheItemPriority .

Uwagi

Parametr item dostarcza klucz i wartość używaną przez metodę . Jeśli pamięć podręczna ma wpis pamięci podręcznej z tym samym kluczem co klucz parametru item , metoda zwraca istniejący wpis jako CacheItem wystąpienie. Jeśli nie ma istniejącego wpisu pamięci podręcznej, metoda tworzy nową przy użyciu klucza i wartości dostarczonej item przez parametr oraz ze szczegółami eksmisji określonymi przez policy.

Ostrzeżenie

Add Przeciążenia metody i AddOrGetExisting nie obsługują UpdateCallback właściwości . W związku z tym, aby ustawić UpdateCallback właściwość dla wpisu pamięci podręcznej, należy zamiast tego użyć Set przeciążeń metody.

AddOrGetExisting(String, Object, DateTimeOffset, String)

Źródło:

MemoryCache.cs

Dodaje wpis pamięci podręcznej do pamięci podręcznej przy użyciu określonego klucza i wartości oraz bezwzględnej wartości wygaśnięcia.

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

Parametry

key

String

Unikatowy identyfikator wpisu pamięci podręcznej do dodania.

value

Object

Dane wpisu pamięci podręcznej.

absoluteExpiration

DateTimeOffset

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

regionName

String

Nazwany region w pamięci podręcznej, do którego można dodać wpis pamięci podręcznej. Nie przekazuj wartości dla tego parametru. Ten parametr jest null domyślnie, ponieważ MemoryCache klasa nie implementuje regionów.

Zwraca

Object

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

Wyjątki

ArgumentNullException

value nie nulljest .

NotSupportedException

regionName nie nulljest .

ArgumentException

Wartości wygasania bezwzględnego i przesuwanego obiektu CacheItemPolicy są ustawione na wartości inne niż wartości domyślne InfiniteAbsoluteExpiration i NoSlidingExpiration pola. Klasa MemoryCache nie może ustawić zasad wygasania na podstawie kombinacji bezwzględnego wygaśnięcia i przesuwanego wygaśnięcia. Tylko jedno ustawienie wygasania można jawnie ustawić podczas korzystania z MemoryCache wystąpienia. Inne ustawienie wygasania musi być ustawione na InfiniteAbsoluteExpiration lub NoSlidingExpiration

ArgumentOutOfRangeException

Właściwość jest ustawiona SlidingExpiration na wartość mniejszą niż Zero.

-lub-

Właściwość SlidingExpiration jest ustawiona na wartość większą niż jeden rok.

-lub-

Właściwość Priority nie jest wartością wyliczenia CacheItemPriority .

Uwagi

Jeśli pamięć podręczna nie ma wpisu pamięci podręcznej, którego klucz pasuje do parametru key , zostanie utworzony nowy wpis pamięci podręcznej, a MemoryCache.AddOrGetExisting przeciążenie metody zwraca wartość null. Jeśli istnieje pasujący wpis pamięci podręcznej, zostanie zwrócony istniejący wpis.

Ostrzeżenie

Add Przeciążenia metody i AddOrGetExisting nie obsługują UpdateCallback właściwości . W związku z tym, aby ustawić UpdateCallback właściwość dla wpisu pamięci podręcznej, należy zamiast tego użyć Set przeciążeń metody.

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Źródło:

MemoryCache.cs

Wstawia wpis pamięci podręcznej do pamięci podręcznej przy użyciu określonego klucza i wartości oraz określone szczegóły dotyczące sposobu eksmitowania.

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

Parametry

key

String

Unikatowy identyfikator wpisu pamięci podręcznej do dodania lub pobrania.

value

Object

Dane wpisu pamięci podręcznej.

policy

CacheItemPolicy

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

regionName

String

Nazwany region w pamięci podręcznej, do którego można dodać wpis pamięci podręcznej. Nie przekazuj wartości dla tego parametru. Domyślnie ten parametr to null, ponieważ MemoryCache klasa nie implementuje regionów.

Zwraca

Object

Jeśli pasujący wpis pamięci podręcznej już istnieje, wpis pamięci podręcznej; w przeciwnym razie , null.

Wyjątki

ArgumentNullException

value to null.

ArgumentException

Wartości wygasania CacheItemPolicy bezwzględnego i przesuwanego obiektu są ustawione na wartości inne niż wartości domyślne InfiniteAbsoluteExpiration i NoSlidingExpiration. Klasa MemoryCache nie może ustawić zasad wygasania na podstawie kombinacji zarówno bezwzględnego, jak i przesuwanego wygaśnięcia. W przypadku korzystania z MemoryCache klasy można jawnie ustawić tylko jedno ustawienie wygasania. Inne ustawienie musi być ustawione na InfiniteAbsoluteExpiration lub NoSlidingExpiration.

-lub-

Zarówno wywołanie zwrotne usuwania, jak i wywołanie zwrotne aktualizacji zostały określone dla CacheItemPolicyelementu . Tylko MemoryCache obsługuje użycie jednego typu wywołania zwrotnego na wpis pamięci podręcznej.

ArgumentOutOfRangeException

Właściwość jest ustawiona SlidingExpiration na wartość mniejszą niż Zero.

-lub-

Właściwość SlidingExpiration została ustawiona na wartość większą niż jeden rok.

-lub-

Właściwość Priority nie jest wartością wyliczenia CacheItemPriority .

Uwagi

Ostrzeżenie

Add Przeciążenia metody i AddOrGetExisting nie obsługują UpdateCallback właściwości . W związku z tym, aby ustawić UpdateCallback właściwość dla wpisu pamięci podręcznej, należy zamiast tego użyć Set przeciążeń metody.