ObjectCache.Add Méthode

Définition

Espace de noms:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Paquet:

System.Runtime.Caching v9.0.0-rc.2.24473.5

En cas de substitution dans une classe dérivée, insère une entrée dans le cache, sans exiger qu'une entrée du cache existante avec une clé correspondante soit retournée.

Surcharges

Add(CacheItem, CacheItemPolicy)	En cas de substitution dans une classe dérivée, tente d'insérer une entrée dans le cache sous forme d'instance CacheItem et ajoute des détails concernant la méthode d'éviction de l'entrée.
Add(String, Object, DateTimeOffset, String)	En cas de substitution dans une classe dérivée, insère une entrée dans le cache sans remplacer d'entrée d'entrée de cache existante.
Add(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 des informations sur le mode de suppression de l'entrée.

Remarques

Les Add surcharges de méthode essaient d’insérer une entrée de cache dans le cache, sans remplacer ou supprimer une entrée de cache existante qui a la même clé. L’entrée de cache peut être un objet typé CacheItem ou un objet générique.

Les AddOrGetExisting surcharges de méthode et les surcharges de Add méthode présentent une différence significative. Lorsque ces méthodes insèrent une entrée de cache, si une entrée correspondante est trouvée dans le cache, les AddOrGetExisting surcharges de méthode retournent l’entrée de cache existante, mais pas les Add surcharges de méthode. Le fait d’avoir ces différentes surcharges de méthode permet aux appelants d’optimiser leur code selon qu’ils ont besoin de l’entrée de cache existante. Dans les caches distribués, le retour d’une valeur existante à l’aide de la méthode peut être plus coûteux que le retour d’une valeur booléenne à l’aide de Add la AddOrGetExisting méthode .

Add(CacheItem, CacheItemPolicy)

Source:

ObjectCache.cs

En cas de substitution dans une classe dérivée, tente d'insérer une entrée dans le cache sous forme d'instance CacheItem et ajoute des détails concernant la méthode d'éviction de l'entrée.

public:
 virtual bool Add(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public virtual bool Add (System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

abstract member Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
override this.Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool

Public Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean

Paramètres

item

CacheItem

Objet à ajouter.

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

Boolean

true si l'insertion a réussi ou false si une entrée du cache possède déjà la même clé que item

Remarques

Les Add surcharges de méthode sont virtuelles (et non abstraites) sur la ObjectCache classe, car la Add méthode appelle AddOrGetExistingen interne . Cela réduit le nombre de surcharges de méthode qu’un implémenteur de cache doit fournir. Si une implémentation de cache ne nécessite aucun comportement spécial pour la Add méthode, elle peut simplement implémenter les surcharges de méthode AddOrGetExisting .

Add(String, Object, DateTimeOffset, String)

Source:

ObjectCache.cs

En cas de substitution dans une classe dérivée, insère une entrée dans le cache sans remplacer d'entrée d'entrée de cache existante.

public virtual bool Add (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

abstract member Add : string * obj * DateTimeOffset * string -> bool
override this.Add : string * obj * DateTimeOffset * string -> bool

Public Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Boolean

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. Ce paramètre est obligatoire lorsque la méthode Add est appelée.

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. Étant donné que les régions ne sont pas implémentées dans .NET Framework 4, la valeur par défaut est null.

Retours

Boolean

true si l'insertion a réussi ou false si une entrée du cache possède déjà la même clé que key

Remarques

Les Add surcharges de méthode sont virtuelles (et non abstraites) sur la ObjectCache classe, car la Add méthode appelle AddOrGetExistingen interne . Cela réduit le nombre de surcharges de méthode qu’un implémenteur de cache doit fournir. Si une implémentation de cache ne nécessite aucun comportement spécial pour la Add méthode, elle peut simplement implémenter les surcharges de méthode AddOrGetExisting .

Add(String, Object, CacheItemPolicy, String)

Source:

ObjectCache.cs

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

public virtual bool Add (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

abstract member Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
override this.Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool

Public Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Boolean

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

Boolean

true en cas d'insertion réussie ou false, si une entrée du cache possède déjà la même clé que key.

Remarques

Les Add surcharges de méthode sont virtuelles (et non abstraites) sur la ObjectCache classe, car la Add méthode appelle AddOrGetExistingen interne . Cela réduit le nombre de surcharges de méthode qu’un implémenteur de cache doit fournir. Si une implémentation de cache ne nécessite aucun comportement spécial pour la Add méthode, elle peut simplement implémenter les surcharges de méthode AddOrGetExisting .