ObjectCache.Add Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- 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 -> boolPublic Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As BooleanParamè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
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 .
S’applique à
Add(String, Object, DateTimeOffset, String)
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- 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 -> boolPublic Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As BooleanParamè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
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 .
S’applique à
Add(String, Object, CacheItemPolicy, String)
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- 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 -> boolPublic Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As BooleanParamè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
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 .
