ObjectCache.Add Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.