Exporter (0) Imprimer
Développer tout

Cache.Add, méthode

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.

Espace de noms : System.Web.Caching
Assembly : System.Web (dans system.web.dll)

public Object Add (
	string key,
	Object value,
	CacheDependency dependencies,
	DateTime absoluteExpiration,
	TimeSpan slidingExpiration,
	CacheItemPriority priority,
	CacheItemRemovedCallback onRemoveCallback
)
public Object Add (
	String key, 
	Object value, 
	CacheDependency dependencies, 
	DateTime absoluteExpiration, 
	TimeSpan slidingExpiration, 
	CacheItemPriority priority, 
	CacheItemRemovedCallback onRemoveCallback
)
public function Add (
	key : String, 
	value : Object, 
	dependencies : CacheDependency, 
	absoluteExpiration : DateTime, 
	slidingExpiration : TimeSpan, 
	priority : CacheItemPriority, 
	onRemoveCallback : CacheItemRemovedCallback
) : Object

Paramètres

key

Clé de cache utilisée pour faire référence à l'élément.

value

Élément à ajouter au cache.

dependencies

Dépendances de fichier ou de clé de cache pour l'élément considéré. Lorsqu'une dépendance change, l'objet n'est plus valide et est supprimé du cache. En l'absence de dépendances, ce paramètre contient référence Null (Nothing en Visual Basic).

absoluteExpiration

Moment auquel l'objet ajouté expire et est supprimé du cache. Si vous utilisez l'expiration décalée, le paramètre absoluteExpiration doit être NoAbsoluteExpiration.

slidingExpiration

Intervalle entre le dernier accès à l'objet ajouté au cache et le moment où cet objet expire. Si cette valeur est équivalente à 20 minutes, l'objet expire et est supprimé du cache 20 minutes après son dernier accès. Si vous utilisez l'expiration absolue, le paramètre slidingExpiration doit être NoSlidingExpiration.

priority

Coût relatif de l'objet exprimé par l'énumération CacheItemPriority. 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.

onRemoveCallback

Délégué qui, s'il est fourni, est appelé lorsqu'un objet est supprimé du cache. Vous pouvez l'utiliser pour notifier aux applications que leurs objets sont supprimés du cache.

Valeur de retour

Object si l'élément était précédemment stocké dans le Cache ; sinon, référence Null (Nothing en Visual Basic).

Type d'exceptionCondition

ArgumentNullException

Le paramètre key ou value a la valeur référence Null (Nothing en Visual Basic).

ArgumentOutOfRangeException

Le paramètre slidingExpiration est affecté d'une valeur inférieure à TimeSpan.Zero ou supérieure à un an.

ArgumentException

Les paramètres absoluteExpiration et slidingExpiration sont tous deux définis pour l'élément que vous tentez d'ajouter au Cache.

Les appels à cette méthode échouent si un élément ayant le même paramètre key se trouve déjà dans le Cache. Pour remplacer un élément existant du Cache utilisant le même paramètre key, utilisez la méthode Insert.

Vous ne pouvez pas définir les paramètres absoluteExpiration et slidingExpiration. Si vous souhaitez que l'élément de cache expire à une heure déterminée, définissez le paramètre absoluteExpiration à l'heure déterminée et affectez au paramètre slidingExpiration la valeur NoSlidingExpiration.

Si vous souhaitez que l'élément de cache expire un certain temps après le dernier accès à l'élément, affectez au paramètre slidingExpiration l'intervalle d'expiration, et au paramètre absoluteExpiration la valeur NoAbsoluteExpiration.

L'exemple suivant crée une méthode AddItemToCache. Lorsque cette méthode est appelée, elle affecte à la propriété itemRemoved la valeur false et enregistre une méthode onRemove avec une nouvelle instance du délégué CacheItemRemovedCallback. La signature du délégué est utilisée dans la méthode RemovedCallback. La méthode AddItemToCache vérifie ensuite la valeur associée à la clé Key1 dans le cache. Si la valeur est référence Null (Nothing en Visual Basic), la méthode Add place un élément dans le cache avec la clé Key1, la valeur Value 1, une expiration absolue de 60 secondes et une priorité de cache élevée. Elle utilise également la méthode onRemove comme argument. Cela permet à la méthode RemovedCallback d'être appelée lorsque cet élément est supprimé du cache.

RemarqueRemarque

Pour obtenir des exemples d'utilisation de la classe CacheDependency et du délégué CacheItemRemovedCallback, consultez Mise en cache de données d'application.

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), TimeSpan.Zero, CacheItemPriority.High, onRemove);
}

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft