ObjectCache.Add Metodo

Definizione

Spazio dei nomi:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Pacchetto:

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

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

Overload

Add(CacheItem, CacheItemPolicy)	Se sottoposto a override in una classe derivata, tenta di inserire una voce della cache nella cache come istanza di CacheItem e aggiunge dettagli sulla modalità di eliminazione della voce.
Add(String, Object, DateTimeOffset, String)	Se sottoposto a override in una classe derivata, inserisce una voce della cache nella cache senza sovrascrivere alcuna voce della cache esistente.
Add(String, Object, CacheItemPolicy, String)	Se sottoposto a override in una classe derivata, inserisce una voce della cache nella cache specificando le informazioni sulla modalità di eliminazione della voce.

Commenti

Gli overload del Add metodo tentano di inserire una voce della cache nella cache, senza sovrascrivere o rimuovere una voce della 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 non gli overload del Add metodo. 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 il Add metodo .

Add(CacheItem, CacheItemPolicy)

Origine:

ObjectCache.cs

Se sottoposto a override in una classe derivata, tenta di inserire una voce della cache nella cache come istanza di CacheItem e aggiunge dettagli sulla modalità di eliminazione della 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 contenente i dettagli sull'eliminazione per la voce della cache. Questo oggetto fornisce più opzioni per l'eliminazione di una semplice scadenza assoluta.

Restituisce

Boolean

true se l'inserimento è riuscito, oppure false se la cache contiene già una voce 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 deve essere fornito da un implementatore della cache. Se un'implementazione della cache non richiede alcun comportamento speciale per il Add metodo, può semplicemente implementare gli overload del AddOrGetExisting metodo.

Add(String, Object, DateTimeOffset, String)

Origine:

ObjectCache.cs

Se sottoposto a override in una classe derivata, inserisce una voce della cache nella cache senza sovrascrivere alcuna voce della 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 della voce della cache.

value

Object

Oggetto da inserire.

absoluteExpiration

DateTimeOffset

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

regionName

String

facoltativo. Area denominata nella cache alla quale può essere aggiunta la voce della cache, se le aree vengono implementate. Poiché le aree non sono implementate in .NET Framework 4, il valore predefinito è null.

Restituisce

Boolean

true se l'inserimento è riuscito, oppure false se la cache contiene già una voce 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 deve essere fornito da un implementatore della cache. Se un'implementazione della cache non richiede alcun comportamento speciale per il Add metodo, può semplicemente implementare gli overload del AddOrGetExisting metodo.

Add(String, Object, CacheItemPolicy, String)

Origine:

ObjectCache.cs

Se sottoposto a override in una classe derivata, inserisce una voce della cache nella cache specificando le informazioni sulla modalità di eliminazione 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 della voce della cache.

value

Object

Oggetto da inserire.

policy

CacheItemPolicy

Oggetto contenente i dettagli sull'eliminazione per la voce della cache. Questo oggetto fornisce più opzioni per l'eliminazione di una semplice scadenza assoluta.

regionName

String

facoltativo. Area denominata nella cache alla quale può essere aggiunta la voce della cache, se le aree vengono implementate. Il valore predefinito per il parametro facoltativo è null.

Restituisce

Boolean

true se il tentativo di inserimento viene completato oppure false se esiste già 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 deve essere fornito da un implementatore della cache. Se un'implementazione della cache non richiede alcun comportamento speciale per il Add metodo, può semplicemente implementare gli overload del AddOrGetExisting metodo.