ObjectCache.Add Metod

Definition

När den åsidosätts i en härledd klass infogar en cachepost i cacheminnet, utan att det krävs att en befintlig cachepost med en matchande nyckel returneras.

Överlagringar

Name Description
Add(CacheItem, CacheItemPolicy)

När den åsidosätts i en härledd klass försöker du infoga en cachepost i cacheminnet som en CacheItem instans och lägger till information om hur posten ska tas bort.

Add(String, Object, DateTimeOffset, String)

När den åsidosättas i en härledd klass infogar en cachepost i cacheminnet utan att skriva över någon befintlig cachepost.

Add(String, Object, CacheItemPolicy, String)

När den åsidosätts i en härledd klass infogar en cachepost i cacheminnet och anger information om hur posten ska tas bort.

Kommentarer

Metoden Add överbelastar försöker infoga en cachepost i cacheminnet, utan att skriva över eller ta bort en befintlig cachepost som har samma nyckel. Cacheposten kan vara ett skrivet CacheItem objekt eller ett allmänt objekt.

Metodens AddOrGetExisting överlagringar och Add metodöverlagringar har en betydande skillnad. När dessa metoder infogar en cachepost returnerar metoden överlagringar den befintliga cacheposten om en matchande post hittas i cachen AddOrGetExisting , men Add metoden överbelastas inte. Med dessa olika metodöverlagringar kan anropare optimera sin kod baserat på om de behöver den befintliga cacheposten. I distribuerade cacheminnen kan det vara dyrare att returnera ett befintligt värde med hjälp AddOrGetExisting av metoden än att returnera ett booleskt värde med hjälp Add av metoden.

Add(CacheItem, CacheItemPolicy)

Källa:
ObjectCache.cs
Källa:
ObjectCache.cs
Källa:
ObjectCache.cs
Källa:
ObjectCache.cs

När den åsidosätts i en härledd klass försöker du infoga en cachepost i cacheminnet som en CacheItem instans och lägger till information om hur posten ska tas bort.

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

Parametrar

item
CacheItem

Objektet som ska läggas till.

policy
CacheItemPolicy

Ett objekt som innehåller borttagningsinformation för cacheposten. Det här objektet innehåller fler alternativ för borttagning än en enkel absolut förfallotid.

Returer

true om insättningen lyckades eller false om det redan finns en post i cacheminnet som har samma nyckel som item.

Kommentarer

Metodens Add överlagringar är virtuella (inte abstrakta) i ObjectCache klassen, eftersom Add metoden internt anropar AddOrGetExisting. Detta minskar antalet metodöverbelastningar som en cache-implementerare måste tillhandahålla. Om en cacheimplementering inte kräver något särskilt beteende för Add metoden kan den bara implementera AddOrGetExisting metodens överlagringar.

Gäller för

Add(String, Object, DateTimeOffset, String)

Källa:
ObjectCache.cs
Källa:
ObjectCache.cs
Källa:
ObjectCache.cs
Källa:
ObjectCache.cs

När den åsidosättas i en härledd klass infogar en cachepost i cacheminnet utan att skriva över någon befintlig cachepost.

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

Parametrar

key
String

En unik identifierare för cacheposten.

value
Object

Objektet som ska infogas.

absoluteExpiration
DateTimeOffset

Det fasta datum och den tid då cacheposten upphör att gälla. Den här parametern krävs när Add metoden anropas.

regionName
String

Optional. En namngiven region i cachen som cacheposten kan läggas till i, om regioner implementeras. Eftersom regioner inte implementeras i .NET Framework 4 är standardvärdet null.

Returer

true om insättningen lyckades eller false om det redan finns en post i cacheminnet som har samma nyckel som key.

Kommentarer

Metodens Add överlagringar är virtuella (inte abstrakta) i ObjectCache klassen, eftersom Add metoden internt anropar AddOrGetExisting. Detta minskar antalet metodöverbelastningar som en cache-implementerare måste tillhandahålla. Om en cacheimplementering inte kräver något särskilt beteende för Add metoden kan den bara implementera AddOrGetExisting metodens överlagringar.

Gäller för

Add(String, Object, CacheItemPolicy, String)

Källa:
ObjectCache.cs
Källa:
ObjectCache.cs
Källa:
ObjectCache.cs
Källa:
ObjectCache.cs

När den åsidosätts i en härledd klass infogar en cachepost i cacheminnet och anger information om hur posten ska tas bort.

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

Parametrar

key
String

En unik identifierare för cacheposten.

value
Object

Objektet som ska infogas.

policy
CacheItemPolicy

Ett objekt som innehåller borttagningsinformation för cacheposten. Det här objektet innehåller fler alternativ för borttagning än en enkel absolut förfallotid.

regionName
String

Optional. En namngiven region i cachen som cacheposten kan läggas till i, om regioner implementeras. Standardvärdet för den valfria parametern är null.

Returer

true om infognings försök lyckas, eller false om det redan finns en post i cacheminnet med samma nyckel som key.

Kommentarer

Metodens Add överlagringar är virtuella (inte abstrakta) i ObjectCache klassen, eftersom Add metoden internt anropar AddOrGetExisting. Detta minskar antalet metodöverbelastningar som en cache-implementerare måste tillhandahålla. Om en cacheimplementering inte kräver något särskilt beteende för Add metoden kan den bara implementera AddOrGetExisting metodens överlagringar.

Gäller för