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 de cache dans le cache, sans exiger qu’une entrée de cache existante avec une clé correspondante soit retournée.
Surcharges
| Nom | Description |
|---|---|
| Add(CacheItem, CacheItemPolicy) |
En cas de substitution dans une classe dérivée, tente d’insérer une entrée de cache dans le cache en tant qu’instance CacheItem et ajoute des détails sur la façon dont l’entrée doit être supprimée. |
| Add(String, Object, DateTimeOffset, String) |
En cas de substitution dans une classe dérivée, insère une entrée de cache dans le cache sans remplacer toute 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 de cache dans le cache, en spécifiant des informations sur la façon dont l’entrée sera supprimée. |
Remarques
Les Add surcharges de méthode tentent 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 ont 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 les Add surcharges de méthode ne le font pas. Le fait d’avoir ces différentes surcharges de méthode permet aux appelants d’optimiser leur code en fonction du besoin de l’entrée de cache existante. Dans les caches distribués, le retour d’une valeur existante à l’aide de la AddOrGetExisting méthode peut être plus coûteux que de renvoyer une valeur booléenne à l’aide Add de la méthode.
Add(CacheItem, CacheItemPolicy)
- 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 de cache dans le cache en tant qu’instance CacheItem et ajoute des détails sur la façon dont l’entrée doit être supprimé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 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
true si l’insertion a réussi ou false s’il existe déjà une entrée dans le cache qui a la même clé que item.
Remarques
Les Add surcharges de méthode sont virtuelles (pas 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 AddOrGetExisting méthode.
S’applique à
Add(String, Object, DateTimeOffset, String)
- 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 de cache dans le cache sans remplacer toute 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 du cache expire. Ce paramètre est requis lorsque la Add méthode est appelée.
- regionName
- String
Optional. Région nommée dans le cache à laquelle l’entrée du 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 s’il existe déjà une entrée dans le cache qui a la même clé que key.
Remarques
Les Add surcharges de méthode sont virtuelles (pas 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 AddOrGetExisting méthode.
S’applique à
Add(String, Object, CacheItemPolicy, String)
- 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 de cache dans le cache, en spécifiant des informations sur la façon dont l’entrée sera supprimé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 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
Optional. Région nommée dans le cache à laquelle l’entrée du 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 si l’insertion réussit, ou false s’il existe déjà une entrée dans le cache avec la même clé que key.
Remarques
Les Add surcharges de méthode sont virtuelles (pas 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 AddOrGetExisting méthode.
