ObjectCache.Add Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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)
- Zdroj:
- ObjectCache.cs
- Zdroj:
- ObjectCache.cs
- Zdroj:
- ObjectCache.cs
- 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 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
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.
Platí pro
Add(String, Object, DateTimeOffset, String)
- Zdroj:
- ObjectCache.cs
- Zdroj:
- ObjectCache.cs
- Zdroj:
- ObjectCache.cs
- 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 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
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.
Platí pro
Add(String, Object, CacheItemPolicy, String)
- Zdroj:
- ObjectCache.cs
- Zdroj:
- ObjectCache.cs
- Zdroj:
- ObjectCache.cs
- Zdroj:
- ObjectCache.cs
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
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.