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 (String, Object, DateTimeOffset, String)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

Aggiunge una voce della cache nella cache usando la chiave e il valore specificati e un valore di scadenza assoluto.

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

public override object AddOrGetExisting(
	string key,
	object value,
	DateTimeOffset absoluteExpiration,
	string regionName = null
)

Parametri

key
Type: System.String

Identificatore univoco della voce della cache da aggiungere.

value
Type: System.Object

Dati per la voce della cache.

absoluteExpiration
Type: System.DateTimeOffset

Data e ora fisse in cui scadrà la voce della cache.

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.

Valore restituito

Type: System.Object

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

Exception Condition
ArgumentNullException

key è null.

NotSupportedException

regionName non è null.

ArgumentNullException

value non è 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.

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 o NoSlidingExpiration

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.

Se la cache non dispone di una voce della cache la cui chiave corrisponde il key parametro, viene creata una nuova voce di cache e MemoryCache.AddOrGetExisting overload del metodo restituisce null. Se esiste una voce della cache corrispondente, la voce esistente.

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: