ObjectCache.Add Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
- 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 -> boolPublic Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As BooleanParametri
- 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
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.
Si applica a
Add(String, Object, DateTimeOffset, String)
- Origine:
- ObjectCache.cs
- 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 -> boolPublic Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As BooleanParametri
- 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
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.
Si applica a
Add(String, Object, CacheItemPolicy, String)
- Origine:
- ObjectCache.cs
- 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 -> boolPublic Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As BooleanParametri
- 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
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.
