MemoryCache.AddOrGetExisting Méthode

Définition

Espace de noms:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Paquet:

System.Runtime.Caching v11.0.0-preview.2.26159.112

Insère une entrée de cache dans le cache.

Surcharges

Nom	Description
AddOrGetExisting(CacheItem, CacheItemPolicy)	Ajoute une entrée de cache dans le cache à l’aide de l’instance spécifiée CacheItem et des détails sur la façon de supprimer l’entrée.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Ajoute une entrée de cache dans le cache à l’aide de la clé spécifiée et d’une valeur et d’une valeur d’expiration absolue.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Insère une entrée de cache dans le cache à l’aide de la clé et de la valeur spécifiées et des détails spécifiés pour la façon dont il doit être supprimé.

Remarques

Les AddOrGetExisting surcharges de méthode sont utilisées pour insérer une entrée de cache dans le cache. Si une entrée de cache avec une clé correspondante n’existe pas, ces méthodes insèrent une nouvelle entrée. Si une entrée de cache avec une clé correspondante existe déjà, elle retourne l’entrée existante.

AddOrGetExisting(CacheItem, CacheItemPolicy)

Source:

MemoryCache.cs

Ajoute une entrée de cache dans le cache à l’aide de l’instance spécifiée CacheItem et des détails sur la façon de supprimer l’entrée.

public:
 override System::Runtime::Caching::CacheItem ^ AddOrGetExisting(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public override System.Runtime.Caching.CacheItem AddOrGetExisting(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

override this.AddOrGetExisting : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> System.Runtime.Caching.CacheItem

Public Overrides Function AddOrGetExisting (item As CacheItem, policy As CacheItemPolicy) As CacheItem

Paramètres

item

CacheItem

Objet à ajouter.

policy

CacheItemPolicy

Objet qui contient des détails d’éviction pour l’entrée du cache. Cet objet fournit plus d’options d’éviction qu’une expiration absolue simple.

Retours

CacheItem

Si une entrée de cache avec la même clé existe, l’entrée de cache existante ; sinon, null.

Exceptions

ArgumentNullException

La Value propriété est null.

ArgumentException

Les valeurs d’expiration absolue et glissante de l’objet CacheItemPolicy sont définies sur des valeurs autres que les valeurs par défaut des champs et NoSlidingExpiration des InfiniteAbsoluteExpiration champs. La MemoryCache classe ne peut pas définir la stratégie d’expiration en fonction d’une combinaison d’une expiration absolue et d’une expiration glissante. Un seul paramètre d’expiration peut être défini explicitement lorsque vous utilisez l’instance MemoryCache . L’autre paramètre d’expiration doit être défini sur InfiniteAbsoluteExpiration champ ou NoSlidingExpiration champ.

ArgumentOutOfRangeException

La SlidingExpiration propriété est définie sur une valeur inférieure à Zero.

- ou -

La SlidingExpiration propriété est définie sur une valeur supérieure à un an.

- ou -

La Priority propriété n’est pas une valeur de l’énumération CacheItemPriority .

Remarques

Le item paramètre fournit la clé et la valeur utilisée par la méthode. Si le cache a une entrée de cache avec la même clé que la item clé du paramètre, la méthode retourne l’entrée existante en tant qu’instance CacheItem . S’il n’existe aucune entrée de cache existante, la méthode en crée une nouvelle à l’aide de la clé et de la valeur fournie par le item paramètre, et avec les détails d’éviction spécifiés par policy.

Avertissement

Les Add surcharges de méthode et AddOrGetExisting de méthode ne prennent pas en charge la UpdateCallback propriété. Par conséquent, pour définir la propriété d’une entrée de UpdateCallback cache, utilisez plutôt les Set surcharges de méthode.

AddOrGetExisting(String, Object, DateTimeOffset, String)

Source:

MemoryCache.cs

Ajoute une entrée de cache dans le cache à l’aide de la clé spécifiée et d’une valeur et d’une valeur d’expiration absolue.

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

override this.AddOrGetExisting : string * obj * DateTimeOffset * string -> obj

Public Overrides Function AddOrGetExisting (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Object

Paramètres

key

String

Identificateur unique de l’entrée de cache à ajouter.

value

Object

Données de l’entrée de cache.

absoluteExpiration

DateTimeOffset

Date et heure fixes auxquelles l’entrée du cache expire.

regionName

String

Région nommée dans le cache à laquelle une entrée de cache peut être ajoutée. Ne passez pas de valeur pour ce paramètre. Ce paramètre est null par défaut, car la MemoryCache classe n’implémente pas les régions.

Retours

Object

Si une entrée de cache avec la même clé existe, l’entrée de cache existante ; sinon, null.

Exceptions

ArgumentNullException

value n’est pas null.

NotSupportedException

regionName n’est pas null.

ArgumentException

Les valeurs d’expiration absolue et glissante de l’objet CacheItemPolicy sont définies sur des valeurs autres que les valeurs par défaut des champs et NoSlidingExpiration des InfiniteAbsoluteExpiration champs. La MemoryCache classe ne peut pas définir la stratégie d’expiration en fonction d’une combinaison d’une expiration absolue et d’une expiration glissante. Un seul paramètre d’expiration peut être défini explicitement lorsque vous utilisez l’instance MemoryCache . L’autre paramètre d’expiration doit être défini sur InfiniteAbsoluteExpiration ou NoSlidingExpiration

ArgumentOutOfRangeException

La SlidingExpiration propriété est définie sur une valeur inférieure à Zero.

- ou -

La SlidingExpiration propriété est définie sur une valeur supérieure à un an.

- ou -

La Priority propriété n’est pas une valeur de l’énumération CacheItemPriority .

Remarques

Si le cache n’a pas d’entrée de cache dont la clé correspond au key paramètre, une nouvelle entrée de cache est créée et la surcharge de MemoryCache.AddOrGetExisting méthode retourne null. Si une entrée de cache correspondante existe, l’entrée existante est retournée.

Avertissement

Les Add surcharges de méthode et AddOrGetExisting de méthode ne prennent pas en charge la UpdateCallback propriété. Par conséquent, pour définir la propriété d’une entrée de UpdateCallback cache, utilisez plutôt les Set surcharges de méthode.

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Source:

MemoryCache.cs

Insère une entrée de cache dans le cache à l’aide de la clé et de la valeur spécifiées et des détails spécifiés pour la façon dont il doit être supprimé.

public override object AddOrGetExisting(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

override this.AddOrGetExisting : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> obj

Public Overrides Function AddOrGetExisting (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Object

Paramètres

key

String

Identificateur unique de l’entrée de cache à ajouter ou obtenir.

value

Object

Données de l’entrée de cache.

policy

CacheItemPolicy

Objet qui contient des détails d’éviction pour l’entrée du cache. Cet objet fournit plus d’options d’éviction qu’une expiration absolue simple.

regionName

String

Région nommée dans le cache à laquelle une entrée de cache peut être ajoutée. Ne passez pas de valeur pour ce paramètre. Par défaut, ce paramètre est null, car la MemoryCache classe n’implémente pas les régions.

Retours

Object

Si une entrée de cache correspondante existe déjà, une entrée de cache ; sinon, null.

Exceptions

ArgumentNullException

value a la valeur null.

ArgumentException

Les valeurs d’expiration absolue et glissante de l’objet CacheItemPolicy sont définies sur des valeurs autres que les valeurs par défaut et InfiniteAbsoluteExpirationNoSlidingExpiration. La MemoryCache classe ne peut pas définir la stratégie d’expiration en fonction d’une combinaison d’une valeur absolue et d’une expiration glissante. Un seul paramètre d’expiration peut être défini explicitement lorsque vous utilisez la MemoryCache classe. L’autre paramètre doit être défini sur InfiniteAbsoluteExpiration ou NoSlidingExpiration.

- ou -

Le rappel de suppression et le rappel de mise à jour ont été spécifiés pour CacheItemPolicy. La MemoryCache seule prise en charge de l’utilisation d’un type de rappel par entrée de cache.

ArgumentOutOfRangeException

La SlidingExpiration propriété est définie sur une valeur inférieure à Zero.

- ou -

La SlidingExpiration valeur a été définie sur une valeur supérieure à un an.

- ou -

La Priority propriété n’est pas une valeur de l’énumération CacheItemPriority .

Remarques

Avertissement

Les Add surcharges de méthode et AddOrGetExisting de méthode ne prennent pas en charge la UpdateCallback propriété. Par conséquent, pour définir la propriété d’une entrée de UpdateCallback cache, utilisez plutôt les Set surcharges de méthode.