MemoryCache.Set 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.
Inserisce una voce della cache nella cache.
Overload
| Set(CacheItem, CacheItemPolicy) |
Inserisce una voce della cache nella cache usando un'istanza di CacheItem per specificare la chiave e il valore per la voce della cache. |
| Set(String, Object, DateTimeOffset, String) |
Inserisce una voce della cache nella cache usando una chiave e un valore e specifica i dettagli della scadenza basati sull'ora. |
| Set(String, Object, CacheItemPolicy, String) |
Inserisce una voce della cache nella cache usando una chiave, un valore e l'eliminazione. |
Commenti
Se la voce specificata non esiste, viene creata. Se la voce specificata esiste, viene aggiornata.
Set(CacheItem, CacheItemPolicy)
- Origine:
- MemoryCache.cs
- Origine:
- MemoryCache.cs
Inserisce una voce della cache nella cache usando un'istanza di CacheItem per specificare la chiave e il valore per la voce della cache.
public:
override void Set(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);public override void Set (System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);override this.Set : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> unitPublic Overrides Sub Set (item As CacheItem, policy As CacheItemPolicy)Parametri
- item
- CacheItem
Oggetto che rappresenta una voce della cache 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.
Eccezioni
È stata passata una combinazione non valida di argomenti per la voce della cache. Questo si verifica se i seguenti dettagli relativi alla scadenza vengono impostati sull'oggetto criteri per la voce della cache:
Se i valori di scadenza assoluti e scorrevoli dell'oggetto CacheItemPolicy vengono impostati su valori diversi dai valori predefiniti di InfiniteAbsoluteExpiration e NoSlidingExpiration . La classe MemoryCache non può impostare criteri di scadenza basati su una scadenza assoluta e una scadenza variabile. Quando si utilizza la classe MemoryCache, è possibile configurare esplicitamente solo un'impostazione di scadenza. L'altra impostazione deve essere impostata sulla proprietà InfiniteAbsoluteExpiration o NoSlidingExpiration.
Se per l'oggetto vengono specificati CacheItemPolicy sia il callback di rimozione che il callback di aggiornamento. La classe MemoryCache supporta solo l'utilizzo di un tipo di callback per voce della cache.
La proprietà SlidingExpiration è impostata su un valore minore di Zero.
-oppure-
La proprietà SlidingExpiration è impostata su un valore superiore a un anno.
-oppure-
Priority non è un valore dell'enumerazione CacheItemPriority.
Commenti
Analogamente ad altri Set overload di metodo, il Set metodo inserisce sempre un valore della cache nella cache, indipendentemente dal fatto che esista già una voce con la stessa chiave. Se la voce specificata non esiste nella cache, viene inserita una nuova voce della cache. Se la voce specificata esiste già, il relativo valore viene aggiornato.
Si applica a
Set(String, Object, DateTimeOffset, String)
- Origine:
- MemoryCache.cs
- Origine:
- MemoryCache.cs
Inserisce una voce della cache nella cache usando una chiave e un valore e specifica i dettagli della scadenza basati sull'ora.
public override void Set (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);override this.Set : string * obj * DateTimeOffset * string -> unitPublic Overrides Sub Set (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing)Parametri
- key
- String
Identificatore univoco della voce della cache da inserire.
- value
- Object
Dati per la voce della cache.
- absoluteExpiration
- DateTimeOffset
Data e ora fisse in cui scadrà la voce della cache.
- regionName
- String
Area denominata nella cache alla quale può essere aggiunta una voce della cache. Non passare alcun valore per questo parametro. Questo parametro è null per impostazione predefinita, perché la classe MemoryCache non implementa le aree.
Eccezioni
regionName non è null.
È stata passata una combinazione non valida di argomenti per la voce della cache. Questo si verifica se i seguenti dettagli relativi alla scadenza vengono impostati sull'oggetto criteri per la voce della cache:
Se i valori di scadenza assoluti e scorrevoli nell'oggetto CacheItemPolicy vengono impostati su valori diversi dai valori predefiniti di InfiniteAbsoluteExpiration e NoSlidingExpiration. Questo si verifica perché la classe MemoryCache non supporta voci in scadenza basate sia su una scadenza assoluta che su una scadenza variabile. Quando si utilizza la classe MemoryCache, è possibile configurare esplicitamente solo un'impostazione di scadenza. L'altra impostazione deve essere InfiniteAbsoluteExpiration o NoSlidingExpiration.
Se sia il callback di rimozione che il callback di aggiornamento vengono specificati nell'oggetto CacheItemPolicy . La classe MemoryCache supporta solo l'utilizzo di un tipo di callback per voce della cache.
La proprietà SlidingExpiration è impostata su un valore minore di Zero.
-oppure-
La proprietà SlidingExpiration è impostata su un valore superiore a un anno.
-oppure-
- La proprietà Priority non è un valore dell'enumerazione CacheItemPriority.
Commenti
Analogamente ad altri Set overload di metodo, il Set metodo inserisce sempre un valore della cache nella cache, indipendentemente dal fatto che esista già una voce con la stessa chiave. Se la voce specificata non esiste, viene inserita una nuova voce della cache. Se la voce specificata esiste, viene aggiornata.
Il absoluteExpiration parametro indica quando la voce deve essere rimossa dalla cache.
La rimozione di una voce attiva tutti i monitoraggi delle modifiche associati. Se l'elemento rimosso è stato associato a un oggetto o a un CacheItemUpdateCallback oggetto, il motivo della rimozione passato ai callback è contenuto nella Removed proprietà .CacheItemRemovedCallback
Si applica a
Set(String, Object, CacheItemPolicy, String)
- Origine:
- MemoryCache.cs
- Origine:
- MemoryCache.cs
Inserisce una voce della cache nella cache usando una chiave, un valore e l'eliminazione.
public override void Set (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);override this.Set : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> unitPublic Overrides Sub Set (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing)Parametri
- key
- String
Identificatore univoco della voce della cache da inserire.
- value
- Object
Dati per la voce della cache.
- 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
Area denominata nella cache alla quale può essere aggiunta una voce della cache. Non passare alcun valore per questo parametro. Questo parametro è null per impostazione predefinita, perché la classe MemoryCache non implementa le aree.
Eccezioni
key è null.
-oppure-
value è null
-oppure-
Il riferimento al callback passato al metodo di supporto nella proprietà UpdateCallback è null.
Esiste una combinazione non valida di argomenti per la voce della cache. Questo si verifica se i seguenti dettagli relativi alla scadenza vengono impostati sull'oggetto criteri per la voce della cache:
Se i valori di scadenza assoluti e scorrevoli nell'oggetto CacheItemPolicy vengono impostati su valori diversi dai valori predefiniti di InfiniteAbsoluteExpiration e NoSlidingExpiration. Questo accade perché la classe MemoryCache non supporta voci in scadenza basate sia su una scadenza assoluta che su una scadenza variabile. Quando si utilizza la classe MemoryCache, è possibile configurare esplicitamente solo un'impostazione di scadenza. L'altra impostazione deve essere InfiniteAbsoluteExpiration o NoSlidingExpiration.
Se nella classe vengono specificati CacheItemPolicy sia il callback di rimozione che il callback di aggiornamento. La classe MemoryCache supporta solo l'utilizzo di un tipo di callback per voce della cache.
La proprietà SlidingExpiration è impostata su un valore minore di Zero.
-oppure-
La proprietà SlidingExpiration è impostata su un valore superiore a un anno.
-oppure-
La proprietà Priority non è un valore dell'enumerazione CacheItemPriority.
regionName non è null.
Commenti
Analogamente ad altri Set overload di metodo, il Set metodo inserisce sempre un valore della cache nella cache, indipendentemente dal fatto che esista già una voce corrispondente. Se la voce specificata non esiste nella cache, viene inserita una nuova voce della cache. Se la voce specificata esiste, viene aggiornata.
La rimozione di una voce attiva tutti i monitoraggi delle modifiche associati. Se l'elemento rimosso è stato associato a un oggetto o a un CacheItemUpdateCallback oggetto, il motivo della rimozione passato ai callback è contenuto nella Removed proprietà .CacheItemRemovedCallback
