ObjectCache.AddOrGetExisting Méthode

Définition

Espace de noms:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

En cas de substitution dans une classe dérivée, tente d'insérer une entrée dans le cache et retourne une entrée du cache existante avec une clé correspondante.

Surcharges

AddOrGetExisting(CacheItem, CacheItemPolicy)	En cas de substitution dans une classe dérivée, insère l'objet CacheItem spécifié dans le cache, en spécifiant des informations sur le mode de suppression de l'entrée.
AddOrGetExisting(String, Object, DateTimeOffset, String)	En cas de substitution dans une classe dérivée, insère une entrée dans le cache, à l'aide d'une clé, d'un objet pour l'entrée du cache, d'une valeur d'expiration absolue et d'une région facultative dans laquelle ajouter le cache.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	En cas de substitution dans une classe dérivée, insère une entrée dans le cache, en spécifiant une clé et une valeur pour l'entrée du cache, ainsi que des informations sur le mode de suppression de l'entrée.

Remarques

La AddOrGetExisting méthode surcharge l’insertion d’une entrée dans le cache. Si une entrée de cache avec une clé correspondante existe déjà, elle retourne l’entrée existante. L’entrée de cache peut être un CacheItem objet ou un objet générique.

Il existe une différence entre les AddOrGetExisting surcharges et les Add surcharges. Lorsque ces méthodes surchargées tentent d’insérer une entrée de cache, si une entrée existante est trouvée qui a une clé qui correspond à une entrée de cache insérée existante, les AddOrGetExisting surcharges retournent l’entrée de cache existante. Les Add surcharges ne le font pas.

AddOrGetExisting(CacheItem, CacheItemPolicy)

En cas de substitution dans une classe dérivée, insère l'objet CacheItem spécifié dans le cache, en spécifiant des informations sur le mode de suppression de l'entrée.

public:
 abstract System::Runtime::Caching::CacheItem ^ AddOrGetExisting(System::Runtime::Caching::CacheItem ^ value, System::Runtime::Caching::CacheItemPolicy ^ policy);

public abstract System.Runtime.Caching.CacheItem AddOrGetExisting (System.Runtime.Caching.CacheItem value, System.Runtime.Caching.CacheItemPolicy policy);

abstract member AddOrGetExisting : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> System.Runtime.Caching.CacheItem

Public MustOverride Function AddOrGetExisting (value As CacheItem, policy As CacheItemPolicy) As CacheItem

Paramètres

value

CacheItem

Objet à insérer.

policy

CacheItemPolicy

Objet qui contient les informations d'éviction de l'entrée de cache. Cet objet fournit des options d'éviction autres que la simple expiration absolue.

Retours

CacheItem

S'il existe une entrée de cache ayant la même clé, entrée de cache spécifiée ; sinon, null.

AddOrGetExisting(String, Object, DateTimeOffset, String)

En cas de substitution dans une classe dérivée, insère une entrée dans le cache, à l'aide d'une clé, d'un objet pour l'entrée du cache, d'une valeur d'expiration absolue et d'une région facultative dans laquelle ajouter le cache.

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

abstract member AddOrGetExisting : string * obj * DateTimeOffset * string -> obj

Public MustOverride 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.

value

Object

Objet à insérer.

absoluteExpiration

DateTimeOffset

Date et heure fixes auxquelles l'entrée de cache expirera.

regionName

String

Optionnel. Région nommée du cache à laquelle l'entrée de cache peut être ajoutée, si des régions sont implémentées. La valeur par défaut du paramètre facultatif est null.

Retours

Object

S'il existe une entrée du cache ayant la même clé, valeur de l'entrée de cache spécifiée ; sinon, null.

Remarques

Cette AddOrGetExisting(String, Object, DateTimeOffset, String) surcharge de méthode retourne une valeur d’objet, et non un CacheItem objet.

AddOrGetExisting(String, Object, CacheItemPolicy, String)

En cas de substitution dans une classe dérivée, insère une entrée dans le cache, en spécifiant une clé et une valeur pour l'entrée du cache, ainsi que des informations sur le mode de suppression de l'entrée.

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

abstract member AddOrGetExisting : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> obj

Public MustOverride 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.

value

Object

Objet à insérer.

policy

CacheItemPolicy

Objet qui contient les informations d'éviction de l'entrée de cache. Cet objet fournit des options d'éviction autres que la simple expiration absolue.

regionName

String

Optionnel. Région nommée du cache à laquelle l'entrée de cache peut être ajoutée, si des régions sont implémentées. La valeur par défaut du paramètre facultatif est null.

Retours

Object

S'il existe une entrée du cache ayant la même clé, valeur de l'entrée de cache spécifiée ; sinon, null.

Remarques

La AddOrGetExisting(String, Object, CacheItemPolicy, String) méthode retourne une valeur d’objet, et non un CacheItem objet.