ObjectCache.Add Metodo

Definizione

Spazio dei nomi:
System.Runtime.Caching
Assembly:
System.Runtime.Caching.dll

Quando sottoposto a override in una classe derivata, inserisce una voce della cache nella cache, senza richiedere che venga restituita una voce di cache esistente con una chiave corrispondente.

Overload

Nome Descrizione
Add(CacheItem, CacheItemPolicy)

Quando sottoposto a override in una classe derivata, tenta di inserire una voce della cache nella cache come CacheItem istanza e aggiunge informazioni dettagliate su come rimuovere la voce.
Add(String, Object, DateTimeOffset, String)

Quando sottoposto a override in una classe derivata, inserisce una voce della cache nella cache senza sovrascrivere alcuna voce di cache esistente.
Add(String, Object, CacheItemPolicy, String)

Quando sottoposto a override in una classe derivata, inserisce una voce della cache nella cache, specificando le informazioni sulla modalità di rimozione della voce.

Commenti

Gli overload del Add metodo tentano di inserire una voce della cache nella cache, senza sovrascrivere o rimuovere una voce di cache esistente con la stessa chiave. La voce della cache può essere un oggetto tipizzato o un oggetto generico CacheItem .

Gli overload del AddOrGetExisting metodo e gli overload del Add metodo presentano una differenza significativa. Quando questi metodi inseriscono una voce della cache, se viene trovata una voce corrispondente nella cache, gli overload del AddOrGetExisting metodo restituiscono la voce della cache esistente, ma gli overload del Add metodo non lo fanno. La presenza di questi overload di metodi diversi consente ai chiamanti di ottimizzare il codice in base alla necessità della voce della cache esistente. Nelle cache distribuite, la restituzione di un valore esistente tramite il AddOrGetExisting metodo potrebbe essere più costosa rispetto alla restituzione di un valore booleano tramite Add il metodo .

Add(CacheItem, CacheItemPolicy)

Quando sottoposto a override in una classe derivata, tenta di inserire una voce della cache nella cache come CacheItem istanza e aggiunge informazioni dettagliate su come rimuovere la voce.

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

Parametri

item
CacheItem

Oggetto da aggiungere.

policy
CacheItemPolicy

Oggetto che contiene i dettagli di rimozione per la voce della cache. Questo oggetto offre più opzioni per la rimozione rispetto a una semplice scadenza assoluta.

Valori restituiti

Boolean

true se l'inserimento è riuscito o false se è già presente una voce nella cache con la stessa chiave di item.

Commenti

Gli overload del Add metodo sono virtuali (non astratti) nella ObjectCache classe , perché il Add metodo chiama AddOrGetExistinginternamente . In questo modo si riduce il numero di overload dei metodi che un implementatore della cache deve fornire. Se un'implementazione della cache non richiede alcun comportamento speciale per il Add metodo, può semplicemente implementare gli overload del AddOrGetExisting metodo.

Si applica a

Add(String, Object, DateTimeOffset, String)

Quando sottoposto a override in una classe derivata, inserisce una voce della cache nella cache senza sovrascrivere alcuna voce di cache esistente.

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

Parametri

key
String

Identificatore univoco per la voce della cache.

value
Object

Oggetto da inserire.

absoluteExpiration
DateTimeOffset

Data e ora fisse in cui la voce della cache scadrà. Questo parametro è obbligatorio quando viene chiamato il Add metodo .

regionName
String

Facoltativo. Area denominata nella cache in cui è possibile aggiungere la voce della cache, se vengono implementate aree. Poiché le aree non vengono implementate in .NET Framework 4, il valore predefinito è null.

Valori restituiti

Boolean

true se l'inserimento è riuscito o false se è già presente una voce nella cache con la stessa chiave di key.

Commenti

Gli overload del Add metodo sono virtuali (non astratti) nella ObjectCache classe , perché il Add metodo chiama AddOrGetExistinginternamente . In questo modo si riduce il numero di overload dei metodi che un implementatore della cache deve fornire. Se un'implementazione della cache non richiede alcun comportamento speciale per il Add metodo, può semplicemente implementare gli overload del AddOrGetExisting metodo.

Si applica a

Add(String, Object, CacheItemPolicy, String)

Quando sottoposto a override in una classe derivata, inserisce una voce della cache nella cache, specificando le informazioni sulla modalità di rimozione della voce.

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

Parametri

key
String

Identificatore univoco per la voce della cache.

value
Object

Oggetto da inserire.

policy
CacheItemPolicy

Oggetto che contiene i dettagli di rimozione per la voce della cache. Questo oggetto offre più opzioni per la rimozione rispetto a una semplice scadenza assoluta.

regionName
String

Facoltativo. Area denominata nella cache in cui è possibile aggiungere la voce della cache, se vengono implementate aree. Il valore predefinito per il parametro facoltativo è null.

Valori restituiti

Boolean

true se il tentativo di inserimento ha esito positivo o false se è già presente una voce nella cache con la stessa chiave di key.

Commenti

Gli overload del Add metodo sono virtuali (non astratti) nella ObjectCache classe , perché il Add metodo chiama AddOrGetExistinginternamente . In questo modo si riduce il numero di overload dei metodi che un implementatore della cache deve fornire. Se un'implementazione della cache non richiede alcun comportamento speciale per il Add metodo, può semplicemente implementare gli overload del AddOrGetExisting metodo.

Si applica a