CacheDependency Classe

Référence

Définition

Espace de noms:: System.Web.Caching

Assembly:: System.Web.dll

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.

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

public ref class CacheDependency sealed : IDisposable

public ref class CacheDependency : IDisposable

public sealed class CacheDependency : IDisposable

public class CacheDependency : IDisposable

type CacheDependency = class
    interface IDisposable

Public NotInheritable Class CacheDependency
Implements 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 un CacheDependency a changé 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 qui dépend 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 les données d’un fichier XML. Vous pouvez ajouter au DataSet cache avec un CacheDependency objet qui rend dépendant du DataSet fichier XML. Si le fichier XML change, est DataSet supprimé du cache.

Vous pouvez ajouter des éléments avec des dépendances au cache de votre application avec les Add méthodes et Cache.Insert . 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 dont dépend l’élément, puis transmettez la dépendance à la Add méthode ou Cache.Insert . L’instance CacheDependency peut représenter un fichier ou un répertoire unique, 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

CacheDependency()	Initialise une nouvelle instance de la classe CacheDependency.
CacheDependency(String)	Initialise une nouvelle instance de la classe CacheDependency qui surveille un fichier ou un répertoire pour déceler les modifications.
CacheDependency(String, DateTime)	Initialise une nouvelle instance de la classe CacheDependency qui surveille un fichier ou un répertoire pour déceler les modifications.
CacheDependency(String[])	Initialise une nouvelle instance de la classe CacheDependency qui surveille un tableau de chemins d'accès (vers des fichiers ou des répertoires) pour déceler les modifications.
CacheDependency(String[], DateTime)	Initialise une nouvelle instance de la classe CacheDependency qui surveille un tableau de chemins d'accès (vers des fichiers ou des répertoires) pour déceler les modifications et spécifier l'heure à laquelle la surveillance des modifications commence.
CacheDependency(String[], String[])	Initialise une nouvelle instance de la classe CacheDependency 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 déceler les modifications.
CacheDependency(String[], String[], CacheDependency)	Initialise une nouvelle instance de la classe CacheDependency 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 déceler les modifications. Il devient également dépendant d'une instance distincte de la classe CacheDependency.
CacheDependency(String[], String[], CacheDependency, DateTime)	Initialise une nouvelle instance de la classe CacheDependency 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 déceler les modifications. Il devient également dépendant d'une autre instance de la classe CacheDependency et de l'heure à laquelle la surveillance des modifications commence.
CacheDependency(String[], String[], DateTime)	Initialise une nouvelle instance de la classe CacheDependency 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 déceler les modifications.

Propriétés

HasChanged	Obtient une valeur indiquant si l'objet CacheDependency a changé.
UtcLastModified	Obtient l'heure de la dernière modification de la dépendance.

Méthodes

DependencyDispose()	Libère les ressources utilisées par la classe CacheDependency et toutes 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()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetUniqueID()	Récupère un identificateur unique pour un objet CacheDependency.
ItemRemoved()	Appelé lorsqu’une entrée de cache surveillée est supprimée.
KeepDependenciesAlive()	Met à jour l’heure du dernier accès de chaque élément de cache qui dépend de cet élément.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
NotifyDependencyChanged(Object, EventArgs)	Avertit l'objet CacheDependency de base que la dépendance représentée par une classe CacheDependency dérivée a changé.
SetCacheDependencyChanged(Action<Object,EventArgs>)	Ajoute une méthode d’action pour notifier les parties intéressées par les modifications apportées à cette dépendance.
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)

S’applique à

Partage via