ObjectCache.Add Metoda

Definicja

Przestrzeń nazw:

System.Runtime.Caching

Zestaw:

System.Runtime.Caching.dll

Pakiet:

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

Po zastąpieniu w klasie pochodnej wstawia wpis pamięci podręcznej do pamięci podręcznej bez konieczności zwracania istniejącego wpisu pamięci podręcznej z pasującym kluczem.

Przeciążenia

Add(CacheItem, CacheItemPolicy)	Po zastąpieniu w klasie pochodnej próbuje wstawić wpis pamięci podręcznej do pamięci podręcznej jako CacheItem wystąpienie i dodaje szczegółowe informacje na temat sposobu eksmitowania wpisu.
Add(String, Object, DateTimeOffset, String)	Podczas zastępowania w klasie pochodnej wstawia wpis pamięci podręcznej do pamięci podręcznej bez zastępowania istniejącego wpisu pamięci podręcznej.
Add(String, Object, CacheItemPolicy, String)	Po zastąpieniu w klasie pochodnej wstawia wpis pamięci podręcznej do pamięci podręcznej, określając informacje o sposobie eksmitowania wpisu.

Uwagi

Metoda Add przeciąża próby wstawienia wpisu pamięci podręcznej do pamięci podręcznej bez zastępowania lub usuwania istniejącego wpisu pamięci podręcznej, który ma ten sam klucz. Wpis pamięci podręcznej może być obiektem wpisanym CacheItem lub obiektem ogólnym.

Przeciążenia AddOrGetExisting metody i Add przeciążenia metody mają jedną znaczącą różnicę. Gdy te metody wstawią wpis pamięci podręcznej, jeśli w pamięci podręcznej zostanie znaleziony pasujący wpis, AddOrGetExisting przeciążenia metody zwracają istniejący wpis pamięci podręcznej, ale Add przeciążenia metody nie są. Przeciążenia tych różnych metod umożliwiają obiektom wywołującym optymalizowanie kodu na podstawie tego, czy potrzebują istniejącego wpisu pamięci podręcznej. W rozproszonych pamięciach podręcznych zwracanie istniejącej wartości przy użyciu AddOrGetExisting metody może być droższe niż zwracanie wartości logicznej przy użyciu Add metody .

Add(CacheItem, CacheItemPolicy)

Źródło:

ObjectCache.cs

Po zastąpieniu w klasie pochodnej próbuje wstawić wpis pamięci podręcznej do pamięci podręcznej jako CacheItem wystąpienie i dodaje szczegółowe informacje na temat sposobu eksmitowania wpisu.

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

Obiekt do dodania.

policy

CacheItemPolicy

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

Zwraca

Boolean

true jeśli wstawianie powiodło się lub false istnieje już wpis w pamięci podręcznej, który ma ten sam klucz co item.

Uwagi

Przeciążenia Add metody są wirtualne (nie abstrakcyjne) w ObjectCache klasie, ponieważ Add metoda wywołuje wewnętrznie AddOrGetExistingmetodę . Zmniejsza to liczbę przeciążeń metod, które musi zapewnić implementator pamięci podręcznej. Jeśli implementacja pamięci podręcznej nie wymaga żadnego specjalnego zachowania dla Add metody, może po prostu zaimplementować AddOrGetExisting przeciążenia metody.

Add(String, Object, DateTimeOffset, String)

Źródło:

ObjectCache.cs

Podczas zastępowania w klasie pochodnej wstawia wpis pamięci podręcznej do pamięci podręcznej bez zastępowania istniejącego wpisu pamięci podręcznej.

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

Unikatowy identyfikator wpisu pamięci podręcznej.

value

Object

Obiekt do wstawienia.

absoluteExpiration

DateTimeOffset

Stała data i godzina wygaśnięcia wpisu pamięci podręcznej. Ten parametr jest wymagany, gdy wywoływana Add jest metoda.

regionName

String

Opcjonalny. Nazwany region w pamięci podręcznej, do którego można dodać wpis pamięci podręcznej, jeśli regiony są implementowane. Ponieważ regiony nie są implementowane w .NET Framework 4, wartość domyślna to null.

Zwraca

Boolean

true jeśli wstawianie powiodło się lub false istnieje już wpis w pamięci podręcznej, który ma ten sam klucz co key.

Uwagi

Przeciążenia Add metody są wirtualne (nie abstrakcyjne) w ObjectCache klasie, ponieważ Add metoda wywołuje wewnętrznie AddOrGetExistingmetodę . Zmniejsza to liczbę przeciążeń metod, które musi zapewnić implementator pamięci podręcznej. Jeśli implementacja pamięci podręcznej nie wymaga żadnego specjalnego zachowania dla Add metody, może po prostu zaimplementować AddOrGetExisting przeciążenia metody.

Add(String, Object, CacheItemPolicy, String)

Źródło:

ObjectCache.cs

Po zastąpieniu w klasie pochodnej wstawia wpis pamięci podręcznej do pamięci podręcznej, określając informacje o sposobie eksmitowania wpisu.

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

Unikatowy identyfikator wpisu pamięci podręcznej.

value

Object

Obiekt do wstawienia.

policy

CacheItemPolicy

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

regionName

String

Opcjonalny. Nazwany region w pamięci podręcznej, do którego można dodać wpis pamięci podręcznej, jeśli regiony są implementowane. Wartość domyślna opcjonalnego parametru to null.

Zwraca

Boolean

true jeśli próba wstawiania powiedzie się lub false jeśli istnieje już wpis w pamięci podręcznej z tym samym kluczem co key.

Uwagi

Przeciążenia Add metody są wirtualne (nie abstrakcyjne) w ObjectCache klasie, ponieważ Add metoda wywołuje wewnętrznie AddOrGetExistingmetodę . Zmniejsza to liczbę przeciążeń metod, które musi zapewnić implementator pamięci podręcznej. Jeśli implementacja pamięci podręcznej nie wymaga żadnego specjalnego zachowania dla Add metody, może po prostu zaimplementować AddOrGetExisting przeciążenia metody.