MemoryCache.AddOrGetExisting Metoda

Definice

Obor názvů:

System.Runtime.Caching

Sestavení:

System.Runtime.Caching.dll

Balíček:

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

Vloží položku mezipaměti do mezipaměti.

Přetížení

Name	Description
AddOrGetExisting(CacheItem, CacheItemPolicy)	Přidá položku mezipaměti do mezipaměti pomocí zadané CacheItem instance a podrobnosti o tom, jak položku vyřadit.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Přidá položku mezipaměti do mezipaměti pomocí zadaného klíče a hodnoty a absolutní hodnoty vypršení platnosti.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Vloží položku mezipaměti do mezipaměti pomocí zadaného klíče a hodnoty a zadaných podrobností o tom, jak se má vyřadit.

Poznámky

Přetížení AddOrGetExisting metody slouží k vložení položky mezipaměti do mezipaměti. Pokud položka mezipaměti s odpovídajícím klíčem neexistuje, tyto metody vloží novou položku. Pokud položka mezipaměti s odpovídajícím klíčem již existuje, vrátí existující položku.

AddOrGetExisting(CacheItem, CacheItemPolicy)

Zdroj:

MemoryCache.cs

Přidá položku mezipaměti do mezipaměti pomocí zadané CacheItem instance a podrobnosti o tom, jak položku vyřadit.

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

Objekt, který chcete přidat.

policy

CacheItemPolicy

Objekt, který obsahuje podrobnosti vyřazení položky mezipaměti. Tento objekt poskytuje více možností vyřazení než jednoduché absolutní vypršení platnosti.

Návraty

CacheItem

Pokud existuje položka mezipaměti se stejným klíčem, existující položka mezipaměti; v opačném případě . null

Výjimky

ArgumentNullException

Vlastnost Value je null.

ArgumentException

Absolutní i posuvné hodnoty vypršení platnosti objektu CacheItemPolicy jsou nastaveny na jiné hodnoty než výchozí hodnoty InfiniteAbsoluteExpiration a NoSlidingExpiration pole. Třída MemoryCache nemůže nastavit zásady vypršení platnosti na základě kombinace absolutního vypršení platnosti a posuvného vypršení platnosti. Při použití MemoryCache instance je možné explicitně nastavit pouze jedno nastavení vypršení platnosti. Ostatní nastavení vypršení platnosti musí být nastavené na InfiniteAbsoluteExpiration pole nebo NoSlidingExpiration pole.

ArgumentOutOfRangeException

Vlastnost SlidingExpiration je nastavena na hodnotu menší než Zero.

nebo

Vlastnost SlidingExpiration je nastavena na hodnotu větší než jeden rok.

nebo

Vlastnost Priority není hodnotou výčtu CacheItemPriority .

Poznámky

Parametr item poskytuje klíč a hodnotu, kterou metoda používá. Pokud mezipaměť obsahuje položku mezipaměti se stejným klíčem jako klíč parametru item , vrátí metoda existující položku jako CacheItem instanci. Pokud neexistuje žádná položka mezipaměti, metoda vytvoří nový pomocí klíče a hodnoty zadané parametrem item a s podrobnostmi vyřazení zadanými parametrem policy.

Výstraha

Přetížení Add metody AddOrGetExisting vlastnost nepodporují UpdateCallback . Proto chcete-li nastavit UpdateCallback vlastnost pro položku mezipaměti, použijte Set místo toho přetížení metody.

AddOrGetExisting(String, Object, DateTimeOffset, String)

Zdroj:

MemoryCache.cs

Přidá položku mezipaměti do mezipaměti pomocí zadaného klíče a hodnoty a absolutní hodnoty vypršení platnosti.

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

Jedinečný identifikátor položky mezipaměti, který se má přidat.

value

Object

Data pro položku mezipaměti.

absoluteExpiration

DateTimeOffset

Pevné datum a čas, kdy vyprší platnost položky mezipaměti.

regionName

String

Pojmenovaná oblast v mezipaměti, do které lze přidat položku mezipaměti. Nepředávejte hodnotu pro tento parametr. Tento parametr je null ve výchozím nastavení, protože MemoryCache třída neimplementuje oblasti.

Návraty

Object

Pokud existuje položka mezipaměti se stejným klíčem, existující položka mezipaměti; v opačném případě . null

Výjimky

ArgumentNullException

value není null.

NotSupportedException

regionName není null.

ArgumentException

Absolutní i posuvné hodnoty vypršení platnosti objektu CacheItemPolicy jsou nastaveny na jiné hodnoty než výchozí hodnoty InfiniteAbsoluteExpiration a NoSlidingExpiration pole. Třída MemoryCache nemůže nastavit zásady vypršení platnosti na základě kombinace absolutního vypršení platnosti a posuvného vypršení platnosti. Při použití MemoryCache instance je možné explicitně nastavit pouze jedno nastavení vypršení platnosti. Ostatní nastavení vypršení platnosti musí být nastavené na InfiniteAbsoluteExpirationNoSlidingExpiration

ArgumentOutOfRangeException

Vlastnost SlidingExpiration je nastavena na hodnotu menší než Zero.

nebo

Vlastnost SlidingExpiration je nastavena na hodnotu větší než jeden rok.

nebo

Vlastnost Priority není hodnotou výčtu CacheItemPriority .

Poznámky

Pokud mezipaměť nemá položku mezipaměti, jejíž klíč odpovídá key parametru, vytvoří se nová položka mezipaměti a MemoryCache.AddOrGetExisting přetížení metody vrátí null. Pokud existuje odpovídající položka mezipaměti, vrátí se existující položka.

Výstraha

Přetížení Add metody AddOrGetExisting vlastnost nepodporují UpdateCallback . Proto chcete-li nastavit UpdateCallback vlastnost pro položku mezipaměti, použijte Set místo toho přetížení metody.

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Zdroj:

MemoryCache.cs

Vloží položku mezipaměti do mezipaměti pomocí zadaného klíče a hodnoty a zadaných podrobností o tom, jak se má vyřadit.

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

Jedinečný identifikátor položky mezipaměti, který se má přidat nebo získat.

value

Object

Data pro položku mezipaměti.

policy

CacheItemPolicy

Objekt, který obsahuje podrobnosti vyřazení položky mezipaměti. Tento objekt poskytuje více možností vyřazení než jednoduché absolutní vypršení platnosti.

regionName

String

Pojmenovaná oblast v mezipaměti, do které lze přidat položku mezipaměti. Nepředávejte hodnotu pro tento parametr. Ve výchozím nastavení je nulltento parametr , protože MemoryCache třída neimplementuje oblasti.

Návraty

Object

Pokud již existuje odpovídající položka mezipaměti, položka mezipaměti; v opačném případě . null

Výjimky

ArgumentNullException

value je null.

ArgumentException

Absolutní i posuvné hodnoty vypršení platnosti objektu CacheItemPolicy jsou nastaveny InfiniteAbsoluteExpiration na jiné hodnoty než výchozí hodnoty a NoSlidingExpiration. Třída MemoryCache nemůže nastavit zásady vypršení platnosti na základě kombinace absolutního i posuvného vypršení platnosti. Při použití MemoryCache třídy je možné explicitně nastavit pouze jedno nastavení vypršení platnosti. Ostatní nastavení musí být nastaveno na InfiniteAbsoluteExpiration hodnotu nebo NoSlidingExpiration.

nebo

Bylo zadáno zpětné volání odebrání i zpětné volání aktualizace .CacheItemPolicy Jediná MemoryCache podpora použití jednoho typu zpětného volání na položku mezipaměti.

ArgumentOutOfRangeException

Vlastnost SlidingExpiration je nastavena na hodnotu menší než Zero.

nebo

Hodnota SlidingExpiration byla nastavena na hodnotu větší než jeden rok.

nebo

Vlastnost Priority není hodnotou výčtu CacheItemPriority .

Poznámky

Výstraha

Přetížení Add metody AddOrGetExisting vlastnost nepodporují UpdateCallback . Proto chcete-li nastavit UpdateCallback vlastnost pro položku mezipaměti, použijte Set místo toho přetížení metody.