ObjectCache.Add Metoda

Definice

Obor názvů:

System.Runtime.Caching

Sestavení:

System.Runtime.Caching.dll

Balíček:

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

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í

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ží do mezipaměti položku mezipaměti a určí informace o tom, jak bude položka vyřazena.

Poznámky

Přetížení Add metody se 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 typed CacheItem objekt nebo obecný objekt.

Přetížení AddOrGetExisting metody a Add přetížení metody mají jeden významný rozdíl. Když tyto metody vloží položku mezipaměti, pokud se v mezipaměti najde odpovídající položka, AddOrGetExisting vrátí přetížení metody existující položku mezipaměti, ale Add přetížení metody nikoli. Tyto různé metody přetížení umožňují volajícím optimalizovat kód na základě toho, zda 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)

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 pro sečtení

policy

CacheItemPolicy

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

Návraty

Boolean

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

Poznámky

Přetížení Add metody jsou ve třídě virtuální (nikoli abstraktní), ObjectCache protože Add metoda interně volá AddOrGetExisting. Tím se snižuje počet přetížení metod, které musí nástroj pro implementaci mezipaměti poskytovat. Pokud implementace mezipaměti nevyžaduje žádné speciální chování pro metodu Add , může pouze implementovat AddOrGetExisting přetížení metody.

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.

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 položky mezipaměti.

value

Object

Objekt, který se má vložit.

absoluteExpiration

DateTimeOffset

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

regionName

String

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

Návraty

Boolean

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

Poznámky

Přetížení Add metody jsou ve třídě virtuální (nikoli abstraktní), ObjectCache protože Add metoda interně volá AddOrGetExisting. Tím se snižuje počet přetížení metod, které musí nástroj pro implementaci mezipaměti poskytovat. Pokud implementace mezipaměti nevyžaduje žádné speciální chování pro metodu Add , může pouze implementovat AddOrGetExisting přetížení metody.

Add(String, Object, CacheItemPolicy, String)

Při přepsání v odvozené třídě vloží do mezipaměti položku mezipaměti a určí 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 položky mezipaměti.

value

Object

Objekt, který se má vložit.

policy

CacheItemPolicy

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

regionName

String

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

Návraty

Boolean

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

Poznámky

Přetížení Add metody jsou ve třídě virtuální (nikoli abstraktní), ObjectCache protože Add metoda interně volá AddOrGetExisting. Tím se snižuje počet přetížení metod, které musí nástroj pro implementaci mezipaměti poskytovat. Pokud implementace mezipaměti nevyžaduje žádné speciální chování pro metodu Add , může pouze implementovat AddOrGetExisting přetížení metody.