MemoryCache.Set Metodo

Definizione

Spazio dei nomi:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Pacchetto:

System.Runtime.Caching v9.0.0

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

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 -> unit

Public 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

ArgumentNullException

item è null.

-oppure-

La proprietà Key è null.

-oppure-

La proprietà Value è null.

ArgumentException

È 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.

ArgumentOutOfRangeException

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.

Set(String, Object, DateTimeOffset, String)

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 -> unit

Public 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

NotSupportedException

regionName non è null.

ArgumentNullException

key è null.

-oppure-

Value è null.

ArgumentException

• È 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.

ArgumentOutOfRangeException

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

Set(String, Object, CacheItemPolicy, String)

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 -> unit

Public 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

ArgumentNullException

key è null.

-oppure-

value è null

-oppure-

Il riferimento al callback passato al metodo di supporto nella proprietà UpdateCallback è null.

ArgumentException

• 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.

ArgumentOutOfRangeException

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.

NotSupportedException

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