ObjectCache.Add Metoda

Definice

Obor názvů:

System.Runtime.Caching

Sestavení:

System.Runtime.Caching.dll

Balíček:

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

Při přepsání v odvozené třídě vloží položku mezipaměti do mezipaměti, aniž by bylo nutné vrátit existující položku mezipaměti s odpovídajícím klíčem.

Přetížení

Name	Description
Add(CacheItem, CacheItemPolicy)	Při přepsání v odvozené třídě se pokusí vložit položku mezipaměti do mezipaměti jako CacheItem instanci a přidá podrobnosti o tom, jak má být položka vyřazena.
Add(String, Object, DateTimeOffset, String)	Při přepsání v odvozené třídě vloží položku mezipaměti do mezipaměti bez přepsání jakékoli existující položky mezipaměti.
Add(String, Object, CacheItemPolicy, String)	Při přepsání v odvozené třídě vloží položku mezipaměti do mezipaměti a určuje informace o tom, jak bude položka vyřazena.

Poznámky

Metoda Add přetěžuje pokus vložit položku mezipaměti do mezipaměti bez přepsání nebo odebrání existující položky mezipaměti, která má stejný klíč. Položka mezipaměti může být zadaným CacheItem objektem nebo obecným objektem.

Přetížení AddOrGetExisting metody a Add přetížení metody mají jeden významný rozdíl. Pokud tyto metody vloží položku mezipaměti, pokud je nalezena odpovídající položka v mezipaměti, AddOrGetExisting přetížení metody vrátí existující položku mezipaměti, ale Add přetížení metody ne. Díky těmto přetížením různých metod můžou volajícím optimalizovat kód na základě toho, jestli potřebují existující položku mezipaměti. V distribuovaných mezipamětí může být vrácení existující hodnoty pomocí AddOrGetExisting metody dražší než vrácení logické hodnoty pomocí Add metody.

Add(CacheItem, CacheItemPolicy)

Zdroj:

ObjectCache.cs

Při přepsání v odvozené třídě se pokusí vložit položku mezipaměti do mezipaměti jako CacheItem instanci a přidá podrobnosti o tom, jak má být položka vyřazena.

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

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

Boolean

true pokud bylo vložení úspěšné, nebo false pokud již existuje položka v mezipaměti, která má stejný klíč jako item.

Poznámky

Přetížení Add metody jsou virtuální (ne abstraktní) ve ObjectCache třídě, protože Add metoda interně volá AddOrGetExisting. Tím se sníží počet přetížení metod, které implementátor mezipaměti musí poskytnout. Pokud implementace mezipaměti nevyžaduje žádné zvláštní chování pro metodu Add , může pouze implementovat AddOrGetExisting přetížení metody.

Add(String, Object, DateTimeOffset, String)

Zdroj:

ObjectCache.cs

Při přepsání v odvozené třídě vloží položku mezipaměti do mezipaměti bez přepsání jakékoli existující položky mezipaměti.

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

Parametry

key

String

Jedinečný identifikátor pro položku mezipaměti.

value

Object

Objekt, který chcete vložit.

absoluteExpiration

DateTimeOffset

Pevné datum a čas, kdy vyprší platnost položky mezipaměti. Tento parametr je vyžadován při Add zavolání metody.

regionName

String

Optional. Pojmenovaná oblast v mezipaměti, do které lze přidat položku mezipaměti, pokud jsou implementovány oblasti. Vzhledem k tomu, že oblasti nejsou implementovány v rozhraní .NET Framework 4, výchozí hodnota je null.

Návraty

Boolean

true pokud bylo vložení úspěšné, nebo false pokud již existuje položka v mezipaměti, která má stejný klíč jako key.

Poznámky

Přetížení Add metody jsou virtuální (ne abstraktní) ve ObjectCache třídě, protože Add metoda interně volá AddOrGetExisting. Tím se sníží počet přetížení metod, které implementátor mezipaměti musí poskytnout. Pokud implementace mezipaměti nevyžaduje žádné zvláštní chování pro metodu Add , může pouze implementovat AddOrGetExisting přetížení metody.

Add(String, Object, CacheItemPolicy, String)

Zdroj:

ObjectCache.cs

Při přepsání v odvozené třídě vloží položku mezipaměti do mezipaměti a určuje informace o tom, jak bude položka vyřazena.

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

Parametry

key

String

Jedinečný identifikátor pro položku mezipaměti.

value

Object

Objekt, který chcete vložit.

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

Optional. Pojmenovaná oblast v mezipaměti, do které lze přidat položku mezipaměti, pokud jsou implementovány oblasti. Výchozí hodnota volitelného parametru je null.

Návraty

Boolean

true pokud se vložení pokusí o úspěšné nebo false pokud již existuje položka v mezipaměti se stejným klíčem jako key.

Poznámky

Přetížení Add metody jsou virtuální (ne abstraktní) ve ObjectCache třídě, protože Add metoda interně volá AddOrGetExisting. Tím se sníží počet přetížení metod, které implementátor mezipaměti musí poskytnout. Pokud implementace mezipaměti nevyžaduje žádné zvláštní chování pro metodu Add , může pouze implementovat AddOrGetExisting přetížení metody.