CacheDependency CacheDependency CacheDependency CacheDependency Class

Définition

É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.Establishes a dependency relationship between an item stored in an ASP.NET application's Cache object and a file, cache key, an array of either, or another CacheDependency object. 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é.The CacheDependency class monitors the dependency relationships so that when any of them changes, the cached item will be automatically removed.

public ref class CacheDependency : IDisposable
public class CacheDependency : IDisposable
type CacheDependency = class
    interface IDisposable
Public Class CacheDependency
Implements IDisposable
Héritage
CacheDependencyCacheDependencyCacheDependencyCacheDependency
Dérivé
Implémente

Exemples

L’exemple de code suivant montre comment utiliser le HasChanged propriété afin de déterminer si un CacheDependency changé depuis la demande précédente pour un élément dans le Cache.The following code example demonstrates using the HasChanged property to determine whether a CacheDependency changed since the previous request for an item in the Cache. Le dt valeur passée dans le start paramètre est défini sur DateTime.Now.The dt value passed in the start parameter is set to 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 est 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.If you add an item to the cache that is dependent on another object, such as a file or array of files, the dependent item is automatically removed from the cache when the object changes. Par exemple, supposons que vous créez un DataSet objet basé sur les données dans un fichier XML.For example, suppose you create a DataSet object based on data in an XML file. Vous pouvez ajouter la DataSet au cache avec un CacheDependency objet qui rend le DataSet dépendantes sur le fichier XML.You can add the DataSet to the cache with a CacheDependency object that makes the DataSet dependent on the XML file. Si le fichier XML est modifié, le DataSet est supprimé du cache.If the XML file changes, the DataSet is removed from the cache.

Vous pouvez ajouter des éléments avec des dépendances au cache de votre application avec le Add et Cache.Insert méthodes.You can add items with dependencies to your application's cache with the Add and Cache.Insert methods. Vous ne pouvez pas utiliser le Item[String] propriété à ajouter des éléments au cache avec des dépendances.You cannot use the Item[String] property to add items to the cache with dependencies.

Pour définir une dépendance, vous créez une instance de la CacheDependency spécifiant les fichiers, les clés ou les répertoires dont dépend l’élément, de la classe, puis passez la dépendance à la Add ou Cache.Insert (méthode).To set up a dependency, you create an instance of the CacheDependency class, specifying the files, keys, or directories on which the item is dependent, and then pass the dependency to the Add or Cache.Insert method. Le CacheDependency instance peut représenter un seul fichier ou répertoire, un tableau de fichiers ou répertoires ou un tableau de fichiers ou répertoires, ainsi que d’un tableau de clés de cache (celles-ci représentent d’autres éléments stockés dans le Cache objet).The CacheDependency instance can represent a single file or directory, an array of files or directories, or an array of files or directories along with an array of cache keys (these represent other items stored in the Cache object).

Constructeurs

CacheDependency() CacheDependency() CacheDependency() CacheDependency()

Initialise une nouvelle instance de la classe CacheDependency.Initializes a new instance of the CacheDependency class.

CacheDependency(String) CacheDependency(String) CacheDependency(String) CacheDependency(String)

Initialise une nouvelle instance de la classe CacheDependency qui surveille un fichier ou un répertoire pour déceler les modifications.Initializes a new instance of the CacheDependency class that monitors a file or directory for changes.

CacheDependency(String, DateTime) CacheDependency(String, DateTime) CacheDependency(String, DateTime) CacheDependency(String, DateTime)

Initialise une nouvelle instance de la classe CacheDependency qui surveille un fichier ou un répertoire pour déceler les modifications.Initializes a new instance of the CacheDependency class that monitors a file or directory for changes.

CacheDependency(String[]) CacheDependency(String[]) CacheDependency(String[]) 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.Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories) for changes.

CacheDependency(String[], DateTime) CacheDependency(String[], DateTime) CacheDependency(String[], DateTime) 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.Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories) for changes and specifies a time when change monitoring begins.

CacheDependency(String[], String[]) CacheDependency(String[], String[]) CacheDependency(String[], String[]) 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.Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories), an array of cache keys, or both for changes.

CacheDependency(String[], String[], CacheDependency) CacheDependency(String[], String[], CacheDependency) CacheDependency(String[], String[], CacheDependency) 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.Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories), an array of cache keys, or both for changes. Il devient également dépendant d'une instance distincte de la classe CacheDependency.It also makes itself dependent upon a separate instance of the CacheDependency class.

CacheDependency(String[], String[], CacheDependency, DateTime) CacheDependency(String[], String[], CacheDependency, DateTime) CacheDependency(String[], String[], CacheDependency, DateTime) 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.Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories), an array of cache keys, or both for changes. Il devient également dépendant d'une autre instance de la classe CacheDependency et de l'heure à laquelle la surveillance des modifications commence.It also makes itself dependent upon another instance of the CacheDependency class and a time when the change monitoring begins.

CacheDependency(String[], String[], DateTime) CacheDependency(String[], String[], DateTime) CacheDependency(String[], String[], DateTime) 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.Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories), an array of cache keys, or both for changes.

Propriétés

HasChanged HasChanged HasChanged HasChanged

Obtient une valeur indiquant si l'objet CacheDependency a changé.Gets a value indicating whether the CacheDependency object has changed.

UtcLastModified UtcLastModified UtcLastModified UtcLastModified

Obtient l'heure de la dernière modification de la dépendance.Gets the time when the dependency was last changed.

Méthodes

DependencyDispose() DependencyDispose() DependencyDispose() DependencyDispose()

Libère les ressources utilisées par la classe CacheDependency et toutes classes qui dérivent de CacheDependency.Releases the resources used by the CacheDependency class and any classes that derive from CacheDependency.

Dispose() Dispose() Dispose() Dispose()

Libère les ressources utilisées par l'objet CacheDependency.Releases the resources used by the CacheDependency object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FinishInit() FinishInit() FinishInit() FinishInit()

Termine l'initialisation de l'objet CacheDependency.Completes initialization of the CacheDependency object.

GetFileDependencies() GetFileDependencies() GetFileDependencies() GetFileDependencies()

Obtient les dépendances de fichier.Gets the file dependencies.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
GetUniqueID() GetUniqueID() GetUniqueID() GetUniqueID()

Récupère un identificateur unique pour un objet CacheDependency.Retrieves a unique identifier for a CacheDependency object.

ItemRemoved() ItemRemoved() ItemRemoved() ItemRemoved()

Appelé lorsqu’une entrée de cache surveillée est supprimée.Called when a monitored cache entry is removed.

KeepDependenciesAlive() KeepDependenciesAlive() KeepDependenciesAlive() KeepDependenciesAlive()

Met à jour l’heure du dernier accès de chaque élément de cache qui dépend de cet élément.Updates the last access time of every cache item that depends on this item.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
NotifyDependencyChanged(Object, EventArgs) NotifyDependencyChanged(Object, EventArgs) NotifyDependencyChanged(Object, EventArgs) 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é.Notifies the base CacheDependency object that the dependency represented by a derived CacheDependency class has changed.

SetCacheDependencyChanged(Action<Object,EventArgs>) SetCacheDependencyChanged(Action<Object,EventArgs>) SetCacheDependencyChanged(Action<Object,EventArgs>) 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.Adds an Action method to handle notifying interested party in changes to this dependency.

SetUtcLastModified(DateTime) SetUtcLastModified(DateTime) SetUtcLastModified(DateTime) SetUtcLastModified(DateTime)

Marque l'heure de la dernière modification d'une dépendance.Marks the time when a dependency last changed.

TakeOwnership() TakeOwnership() TakeOwnership() TakeOwnership()

Permet au premier utilisateur de déclarer la propriété exclusive de cette dépendance.Allows the first user to declare exclusive ownership of this dependency.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

S’applique à

Voir aussi