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.AddOrGetExisting (CacheItem, CacheItemPolicy)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

Aggiunge una voce della cache nella cache usando l'istanza di CacheItem specificata e i dettagli sulla modalità di eliminazione della voce.

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

public override CacheItem AddOrGetExisting(
	CacheItem item,
	CacheItemPolicy policy
)

Parametri

item
Type: System.Runtime.Caching.CacheItem

Oggetto da aggiungere.

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.

Valore restituito

Type: System.Runtime.Caching.CacheItem

Se esiste una voce della cache con la stessa chiave, la voce della cache esistente; in caso contrario, null.

Exception Condition
ArgumentNullException

item è null.

ArgumentNullException

La proprietà Value è null.

ArgumentException

Un UpdateCallback proprietà è stata fornita.

System_CAPS_noteNota

Il Add e AddOrGetExisting non supportano l'overload del metodo di UpdateCallback proprietà. Pertanto, per impostare il UpdateCallback proprietà per una voce della cache, utilizzare il Set invece gli overload di metodo.

ArgumentException

Assoluto e scorrevole i valori di scadenza per il CacheItemPolicy oggetto sono impostate sui valori diversi da quelli predefiniti del InfiniteAbsoluteExpiration e NoSlidingExpiration campi. La MemoryCache classe non può impostare criteri di scadenza basati su una combinazione di una scadenza assoluta e una scadenza. Solo un'impostazione di scadenza può impostare in modo esplicito quando si utilizza il MemoryCache istanza. L'impostazione di scadenza deve essere impostata su InfiniteAbsoluteExpiration campo o NoSlidingExpiration campo.

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.

Il item parametro fornisce la chiave e il valore utilizzato dal metodo. Se la cache ha una voce della cache con la stessa chiave come chiave della item parametro, il metodo restituisce la voce esistente come un CacheItem istanza. Se non è presente alcuna voce della cache, il metodo crea uno nuovo con la chiave e il valore fornito dal item parametro e con i dettagli di eliminazione specificati da policy.

System_CAPS_warningAvviso

Il Add e AddOrGetExisting non supportano l'overload del metodo di UpdateCallback proprietà. Pertanto, per impostare il UpdateCallback proprietà per una voce della cache, utilizzare il Set invece gli overload di metodo.

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