CacheDependency Classe

Définition

Espace de noms:

System.Web.Caching

Assembly:

System.Web.dll

Établit une relation de dépendance entre un élément stocké dans un objet ASP.NET application Cache et un fichier, une clé de cache, un tableau de l’un ou l’autre CacheDependency objet. La CacheDependency classe surveille les relations de dépendance afin que lorsque l’un d’eux change, l’élément mis en cache est automatiquement supprimé.

public ref class CacheDependency : IDisposable

public class CacheDependency : IDisposable

type CacheDependency = class
    interface IDisposable

Public Class CacheDependency
Implements IDisposable

Héritage

Object

CacheDependency

Dérivé

System.Web.Caching.AggregateCacheDependency

System.Web.Caching.SqlCacheDependency

Implémente

IDisposable

Exemples

L’exemple de code suivant illustre l’utilisation de la HasChanged propriété pour déterminer si une CacheDependency modification a été apportée depuis la demande précédente d’un élément dans le Cache. La dt valeur passée dans le start paramètre est définie sur DateTime.Now.

// Insert the cache item.
CacheDependency dep = new CacheDependency(fileName, dt);
cache.Insert("key", "value", dep);

// Check whether CacheDependency.HasChanged is true.
if (dep.HasChanged)
  Response.Write("<p>The dependency has changed.");  
else Response.Write("<p>The dependency has not changed.");

' Insert the cache item.
Dim dep As New CacheDependency(fileName, dt)
myCache.Insert("key", "value", dep)

' Check whether CacheDependency.HasChanged is true.
If dep.HasChanged Then
   Response.Write("<p>The dependency has changed.")
Else
   Response.Write("<p>The dependency has not changed.")
End If 

Remarques

Si vous ajoutez un élément au cache dépendant d’un autre objet, tel qu’un fichier ou un tableau de fichiers, l’élément dépendant est automatiquement supprimé du cache lorsque l’objet change. Par exemple, supposons que vous créez un DataSet objet basé sur des données dans un fichier XML. Vous pouvez ajouter DataSet le cache à l’aide d’un CacheDependency objet qui rend dépendant DataSet du fichier XML. Si le fichier XML change, il DataSet est supprimé du cache.

Vous pouvez ajouter des éléments avec des dépendances au cache de votre application avec les méthodes et Cache.Insert les Add méthodes. Vous ne pouvez pas utiliser la Item[] propriété pour ajouter des éléments au cache avec des dépendances.

Pour configurer une dépendance, vous créez une instance de la CacheDependency classe, en spécifiant les fichiers, clés ou répertoires sur lesquels l’élément dépend, puis transmettez la dépendance à la ou Cache.Insert à la Add méthode. L’instance CacheDependency peut représenter un seul fichier ou répertoire, un tableau de fichiers ou de répertoires, ou un tableau de fichiers ou de répertoires, ainsi qu’un tableau de clés de cache (ceux-ci représentent d’autres éléments stockés dans l’objet Cache ).

Constructeurs

Nom	Description
CacheDependency()	Initialise une nouvelle instance de la classe CacheDependency.
CacheDependency(String, DateTime)	Initialise une nouvelle instance de la CacheDependency classe qui surveille un fichier ou un répertoire pour les modifications.
CacheDependency(String)	Initialise une nouvelle instance de la CacheDependency classe qui surveille un fichier ou un répertoire pour les modifications.
CacheDependency(String[], DateTime)	Initialise une nouvelle instance de la CacheDependency classe qui surveille un tableau de chemins d’accès (aux fichiers ou répertoires) pour les modifications et spécifie une heure à laquelle la surveillance des modifications commence.
CacheDependency(String[], String[], CacheDependency, DateTime)	Initialise une nouvelle instance de la CacheDependency classe qui surveille un tableau de chemins d’accès (vers des fichiers ou des répertoires), un tableau de clés de cache ou les deux pour les modifications. Elle dépend également d’une autre instance de la CacheDependency classe et d’une heure à laquelle la surveillance des modifications commence.
CacheDependency(String[], String[], CacheDependency)	Initialise une nouvelle instance de la CacheDependency classe qui surveille un tableau de chemins d’accès (vers des fichiers ou des répertoires), un tableau de clés de cache ou les deux pour les modifications. Elle dépend également d’une instance distincte de la CacheDependency classe.
CacheDependency(String[], String[], DateTime)	Initialise une nouvelle instance de la CacheDependency classe qui surveille un tableau de chemins d’accès (vers des fichiers ou des répertoires), un tableau de clés de cache ou les deux pour les modifications.
CacheDependency(String[], String[])	Initialise une nouvelle instance de la CacheDependency classe qui surveille un tableau de chemins d’accès (vers des fichiers ou des répertoires), un tableau de clés de cache ou les deux pour les modifications.
CacheDependency(String[])	Initialise une nouvelle instance de la CacheDependency classe qui surveille un tableau de chemins d’accès (aux fichiers ou répertoires) pour les modifications.

Propriétés

Nom	Description
HasChanged	Obtient une valeur indiquant si l’objet CacheDependency a changé.
UtcLastModified	Obtient l’heure à laquelle la dépendance a été modifiée pour la dernière fois.

Méthodes

Nom	Description
DependencyDispose()	Libère les ressources utilisées par la CacheDependency classe et toutes les classes qui dérivent de CacheDependency.
Dispose()	Libère les ressources utilisées par l’objet CacheDependency .
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FinishInit()	Termine l’initialisation de l’objet CacheDependency .
GetFileDependencies()	Obtient les dépendances de fichier.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetUniqueID()	Récupère un identificateur unique pour un CacheDependency objet.
ItemRemoved()	Appelé lorsqu’une entrée de cache supervisée est supprimée.
KeepDependenciesAlive()	Met à jour la dernière heure d’accès de chaque élément de cache qui dépend de cet élément.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
NotifyDependencyChanged(Object, EventArgs)	Avertit l’objet de base CacheDependency que la dépendance représentée par une classe dérivée CacheDependency a changé.
SetCacheDependencyChanged(Action<Object,EventArgs>)	Ajoute une méthode Action pour gérer la notification des modifications apportées à cette dépendance par partie concernée.
SetUtcLastModified(DateTime)	Marque l’heure de la dernière modification d’une dépendance.
TakeOwnership()	Permet au premier utilisateur de déclarer la propriété exclusive de cette dépendance.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• Cache
• Insert(String, Object, CacheDependency)
• Mise en cache des données d’application