Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo MemoryCache.Set (String, Object, CacheItemPolicy, String)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

Inserisce una voce della cache nella cache usando una chiave, un valore e l'eliminazione.

Spazio dei nomi:   System.Runtime.Caching
Assembly:  System.Runtime.Caching (in System.Runtime.Caching.dll)

public override void Set(
	string key,
	object value,
	CacheItemPolicy policy,
	string regionName = null
)

Parametri

key
Type: System.String

Identificatore univoco della voce della cache da inserire.

value
Type: System.Object

Dati per la voce della cache.

policy
Type: System.Runtime.Caching.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
Type: System.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.

Exception Condition
ArgumentNullException

key è null.

-oppure-

value è null

-oppure-

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

ArgumentException
  • Esiste una combinazione valida di argomenti per la voce della cache. Ciò si verifica se i dettagli di scadenza seguenti vengono impostati sull'oggetto criterio per la voce della cache:

  • Se i valori di scadenza assoluta e scorrevole CacheItemPolicy oggetto sono impostate sui valori diversi da quelli predefiniti del InfiniteAbsoluteExpiration e NoSlidingExpiration. In questo modo la MemoryCache classe non supporta voci in scadenza basate su assoluto e una scadenza. Solo un'impostazione di scadenza può impostare in modo esplicito quando si utilizza la MemoryCache classe. L'altra impostazione deve essere impostata su InfiniteAbsoluteExpiration o NoSlidingExpiration.

  • Se vengono specificati sia il callback di rimozione e il callback di aggiornamento su CacheItemPolicy (classe). La MemoryCache classe supporta l'uso di un tipo di callback per ogni voce della cache.

ArgumentOutOfRangeException

Il SlidingExpiration è impostata su un valore minore di Zero.

-oppure-

Il SlidingExpiration proprietà è impostata su un valore maggiore di un anno.

-oppure-

Il Priority proprietà non è un valore di CacheItemPriority enumerazione.

NotSupportedException

regionName non è null.

Analogamente ad altri Set overload del metodo, il Set metodo inserisce sempre un valore della cache nella cache, indipendentemente dal fatto che una voce corrispondente esiste già. Se la voce specificata non esiste nella cache, viene inserita una nuova voce di cache. Se la voce specificata esiste, viene aggiornato.

Rimozione di una voce attiva monitoraggi delle modifiche associati. Se l'elemento rimosso era associato un CacheItemUpdateCallback oggetto o CacheItemRemovedCallback oggetto, in cui è contenuto il motivo per la rimozione che viene passato ai callback di Removed proprietà.

.NET Framework
Disponibile da 4.0
Torna all'inizio
Mostra: