CacheDependency Classe

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 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
CacheDependency
Dérivé
Implémente

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 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. La dt valeur passée dans le start paramètre a la valeur 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 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.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. Supposons, par exemple, que vous créez un DataSet objet basé sur les données d’un fichier XML.For example, suppose you create a DataSet object based on data in an XML file. Vous pouvez ajouter le DataSet au cache à l’aide d’un CacheDependency objet qui rend le DataSet dépendant du 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 change, 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 à l’aide des Add Cache.Insert méthodes et.You can add items with dependencies to your application's cache with the Add and Cache.Insert methods. Vous ne pouvez pas utiliser la Item[] propriété pour ajouter des éléments au cache avec des dépendances.You cannot use the Item[] property to add items to the cache with dependencies.

Pour configurer une dépendance, vous devez créer une instance de la CacheDependency classe, en spécifiant les fichiers, les clés ou les répertoires dont dépend l’élément, puis passer la dépendance à Add la Cache.Insert méthode ou.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. L' CacheDependency instance 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 (qui représentent d’autres éléments stockés dans l' 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()

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

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)

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[])

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)

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[])

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)

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)

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)

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

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

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()

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()

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

Equals(Object)

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

(Hérité de Object)
FinishInit()

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

GetFileDependencies()

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

GetHashCode()

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

(Hérité de Object)
GetType()

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

(Hérité de Object)
GetUniqueID()

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

ItemRemoved()

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

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()

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

(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é.Notifies the base CacheDependency object that the dependency represented by a derived CacheDependency class has changed.

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)

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

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()

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

(Hérité de Object)

S’applique à

Voir aussi