Cache.Add(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) Méthode

Définition

Ajoute l'élément spécifié à l'objet Cache avec des dépendances, des stratégies d'expiration et de priorité, ainsi qu'un délégué que vous pouvez utiliser pour avertir votre application lorsque l'élément inséré est supprimé du Cache.Adds the specified item to the Cache object with dependencies, expiration and priority policies, and a delegate you can use to notify your application when the inserted item is removed from the Cache.

public:
 System::Object ^ Add(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemPriority priority, System::Web::Caching::CacheItemRemovedCallback ^ onRemoveCallback);
public object Add (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemPriority priority, System.Web.Caching.CacheItemRemovedCallback onRemoveCallback);
member this.Add : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemPriority * System.Web.Caching.CacheItemRemovedCallback -> obj
Public Function Add (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback) As Object

Paramètres

key
String

Clé de cache utilisée pour faire référence à l'élément.The cache key used to reference the item.

value
Object

Élément à ajouter au cache.The item to be added to the cache.

dependencies
CacheDependency

Dépendances de fichier ou de clé de cache pour l'élément considéré.The file or cache key dependencies for the item. Lorsqu'une dépendance change, l'objet n'est plus valide et est supprimé du cache.When any dependency changes, the object becomes invalid and is removed from the cache. En l'absence de dépendances, ce paramètre contient null.If there are no dependencies, this parameter contains null.

absoluteExpiration
DateTime

Moment auquel l'objet ajouté expire et est supprimé du cache.The time at which the added object expires and is removed from the cache. Si vous utilisez l'expiration décalée, le paramètre absoluteExpiration doit être NoAbsoluteExpiration.If you are using sliding expiration, the absoluteExpiration parameter must be NoAbsoluteExpiration.

slidingExpiration
TimeSpan

Intervalle entre le dernier accès à l'objet ajouté au cache et le moment où cet objet expire.The interval between the time the added object was last accessed and the time at which that object expires. Si cette valeur est équivalente à 20 minutes, l'objet expire et est supprimé du cache 20 minutes après son dernier accès.If this value is the equivalent of 20 minutes, the object expires and is removed from the cache 20 minutes after it is last accessed. Si vous utilisez l'expiration absolue, le paramètre slidingExpiration doit être NoSlidingExpiration.If you are using absolute expiration, the slidingExpiration parameter must be NoSlidingExpiration.

priority
CacheItemPriority

Coût relatif de l'objet exprimé par l'énumération CacheItemPriority.The relative cost of the object, as expressed by the CacheItemPriority enumeration. Le cache utilise cette valeur lorsqu'il évince des objets ; les objets de moindre coût sont supprimés du cache avant les objets de coût supérieur.The cache uses this value when it evicts objects; objects with a lower cost are removed from the cache before objects with a higher cost.

onRemoveCallback
CacheItemRemovedCallback

Délégué qui, s'il est fourni, est appelé lorsqu'un objet est supprimé du cache.A delegate that, if provided, is called when an object is removed from the cache. Vous pouvez l'utiliser pour notifier aux applications que leurs objets sont supprimés du cache.You can use this to notify applications when their objects are deleted from the cache.

Retours

Object

Objet qui représente l'élément qui a été ajouté si l'élément était stocké précédemment dans le cache ; sinon, null.An object that represents the item that was added if the item was previously stored in the cache; otherwise, null.

Exceptions

Le paramètre key ou value est null.The key or value parameter is set to null.

Le paramètre slidingExpiration a une valeur inférieure à TimeSpan.Zero ou supérieure à un an.The slidingExpiration parameter is set to less than TimeSpan.Zero or more than one year.

Les paramètres absoluteExpiration et slidingExpiration sont tous deux définis pour l'élément que vous tentez d'ajouter au Cache.The absoluteExpiration and slidingExpiration parameters are both set for the item you are trying to add to the Cache.

Exemples

L’exemple suivant crée une AddItemToCache méthode.The following example creates an AddItemToCache method. Quand cette méthode est appelée, elle affecte itemRemoved à une propriété false la valeur et inscrit une onRemove méthode avec une nouvelle instance du CacheItemRemovedCallback délégué.When this method is called, it sets an itemRemoved property to false and registers an onRemove method with a new instance of the CacheItemRemovedCallback delegate. La signature du délégué est utilisée dans la RemovedCallback méthode.The delegate's signature is used in the RemovedCallback method. La AddItemToCache méthode vérifie ensuite la valeur associée à la Key1 clé dans le cache.The AddItemToCache method then checks the value associated with the Key1 key in the cache. Si la valeur est null , la Add méthode place un élément dans le cache avec une clé Key1 , une valeur, une Value 1 expiration absolue de 60 secondes et une priorité de cache élevée.If the value is null, the Add method places an item in the cache with a key of Key1, a value of Value 1, an absolute expiration of 60 seconds, and a high cache priority. Elle utilise également la onRemove méthode comme argument.It also uses the onRemove method as an argument. Cela permet RemovedCallback d’appeler la méthode lorsque cet élément est supprimé du cache.This allows the RemovedCallback method to be called when this item is removed from the cache.

Notes

Pour obtenir des exemples d’utilisation de la CacheDependency classe et du CacheItemRemovedCallback délégué, consultez mise en cache des données d’application.For examples of how to use the CacheDependency class and the CacheItemRemovedCallback delegate, see Caching Application Data.

public void AddItemToCache(Object sender, EventArgs e) {
    itemRemoved = false;

    onRemove = new CacheItemRemovedCallback(this.RemovedCallback);

    if (Cache["Key1"] == null)
      Cache.Add("Key1", "Value 1", null, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove);
}
Public Sub AddItemToCache(sender As Object, e As EventArgs)
    itemRemoved = false

    onRemove = New CacheItemRemovedCallback(AddressOf Me.RemovedCallback)

    If (IsNothing(Cache("Key1"))) Then
      Cache.Add("Key1", "Value 1", Nothing, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove)
    End If
End Sub

Remarques

Les appels à cette méthode échouent silencieusement si un élément avec le même key paramètre est déjà stocké dans le Cache .Calls to this method will fail silently if an item with the same key parameter is already stored in the Cache. Pour remplacer un élément existant Cache à l’aide du même key paramètre, utilisez la Insert méthode.To overwrite an existing Cache item using the same key parameter, use the Insert method.

Vous ne pouvez pas définir à la fois les absoluteExpiration slidingExpiration paramètres et.You cannot set both the absoluteExpiration and slidingExpiration parameters. Si vous voulez que l’élément de cache expire à un moment donné, vous affectez au absoluteExpiration paramètre l’heure spécifique et au slidingExpiration paramètre la valeur NoSlidingExpiration .If you intend the cache item to expire at a specific time, you set the absoluteExpiration parameter to the specific time, and the slidingExpiration parameter to NoSlidingExpiration.

Si vous voulez que l’élément de cache expire après qu’un certain laps de temps s’est écoulé depuis le dernier accès à l’élément, vous affectez au slidingExpiration paramètre l’intervalle d’expiration et au paramètre la valeur absoluteExpiration NoAbsoluteExpiration .If you intend the cache item to expire after a certain amount of time has passed since the item was last accessed, you set the slidingExpiration parameter to the expiration interval, and the absoluteExpiration parameter to NoAbsoluteExpiration.

S’applique à

Voir aussi