Partager via


CacheDependency Constructeurs

Définition

Initialise une nouvelle instance de la classe CacheDependency.

Surcharges

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

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 fichier ou un répertoire 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[], 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.

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

Initialise une nouvelle instance de la classe CacheDependency.

protected:
 CacheDependency();
protected CacheDependency ();
Protected Sub New ()

Exemples

L’exemple de code suivant est une classe qui implémente cette version du CacheDependency constructeur, car toutes les classes dérivées de CacheDependency sont requises.

' Declare the class.
Public Class CustomCacheDependency 
   Inherits CacheDependency

     ' Constructor with no arguments 
     ' provided by CacheDependency class.
     Public Sub New()
     End Sub
   
     ' Declare a Boolean field named disposedValue.
     ' This will be used by Disposed property.
     Private disposedValue As Boolean                
     
     ' Create accessors for the Disposed property.
     Public Property Disposed As Boolean
       Get
           Return disposedValue
       End Get
       Set (ByVal value As Boolean)
           disposedValue = value
       End Set
     End Property
     
     ' Create a public method that sets the latest
     ' changed time of the CustomCacheDependency
     ' and notifies the underlying CacheDependency that the 
     ' dependency has changed, even though the HasChanged
     ' property is false.
     Public Sub ResetDependency()
        If Me.HasChanged = False              
           SetUtcLastModified(DateTime.MinValue)
           NotifyDependencyChanged(Me, EventArgs.Empty)
        End If
     End Sub
     
     ' Overrides the DependencyDispose method to set the
     ' Disposed proerty to true. This method automatically
     ' notifies the underlying CacheDependency object to 
     ' release any resources associated with this class. 
     Protected Overrides Sub DependencyDispose()
        Disposed = True
     End Sub
     
     
 End Class

Remarques

Si vous souhaitez dériver votre propre classe de CacheDependency, implémentez cette version du CacheDependency constructeur.

Voir aussi

S’applique à

CacheDependency(String)

Initialise une nouvelle instance de la classe CacheDependency qui surveille un fichier ou un répertoire pour déceler les modifications.

public:
 CacheDependency(System::String ^ filename);
public CacheDependency (string filename);
new System.Web.Caching.CacheDependency : string -> System.Web.Caching.CacheDependency
Public Sub New (filename As String)

Paramètres

filename
String

Chemin d'accès vers un fichier ou un répertoire dont l'objet mis en cache dépend. Lorsque cette ressource change, l'objet mis en cache devient obsolète et est supprimé du cache.

Exemples

L’exemple de code suivant crée une instance de la CacheDependency classe avec une dépendance sur un fichier XML. La Cache.Insert méthode ajoute ensuite un élément au Cache qui dépend de ce fichier.

CacheDependency dep = new CacheDependency(Server.MapPath("isbn.xml"));
Cache.Insert("ISBNData", Source, dep);

Dim dep As New CacheDependency(Server.MapPath("isbn.xml"))
    Cache.Insert("ISBNData", Source, dep)

Vous pouvez également utiliser la technique suivante pour ajouter un élément à avec Cache une dépendance sur un fichier.

// Make key1 dependent on a file.
CacheDependency dependency = new CacheDependency(Server.MapPath("isbn.xml"));

Cache.Insert("key1", "Value 1", dependency);
    ' Make key1 dependent on a file.
    Dim dependency as new CacheDependency(Server.MapPath("isbn.xml"))

    Cache.Insert("key1", "Value 1", dependency)
End If

Remarques

Si le répertoire ou le fichier spécifié dans le filename paramètre est introuvable dans le système de fichiers, il est traité comme manquant. Si le répertoire ou le fichier est manquant lorsque l’objet avec la dépendance est ajouté à , Cachel’objet mis en cache est supprimé du lors de la Cache création du répertoire ou du fichier.

Par exemple, supposons que vous ajoutez un objet à avec Cache une dépendance sur le chemin de fichier suivant : c :\stocks\xyz.dat. Si ce fichier est introuvable lors de la création de l’objet CacheDependency , mais qu’il est créé ultérieurement, l’objet mis en cache est supprimé lors de la création du fichier xyz.dat.

Voir aussi

S’applique à

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.

public:
 CacheDependency(cli::array <System::String ^> ^ filenames);
public CacheDependency (string[] filenames);
new System.Web.Caching.CacheDependency : string[] -> System.Web.Caching.CacheDependency
Public Sub New (filenames As String())

Paramètres

filenames
String[]

Tableau de chemins d'accès (vers des fichiers ou des répertoires) dont dépend l'objet mis en cache. Lorsque l'une de ces ressources change, l'objet mis en cache devient obsolète et est supprimé du cache.

Exemples

L’exemple de code suivant montre comment utiliser la Cache.Insert méthode pour ajouter un élément à avec des Cache dépendances sur un tableau de fichiers. Vous pouvez également rendre l’élément dépendant d’un tableau de répertoires.

    // Make key1 dependent on several files.
    String[] files = new String[2];
    files[0] = Server.MapPath("isbn.xml");
    files[1] = Server.MapPath("customer.xml");
    CacheDependency dependency = new CacheDependency(files);

    Cache.Insert("key1", "Value 1", dependency);
}
    ' Make key1 dependent on several files.
    Dim files(2) as String
    files(0) = Server.MapPath("isbn.xml")
    files(1) = Server.MapPath("customer.xml")
    Dim dependency as new CacheDependency(files)

    Cache.Insert("key1", "Value 1", dependency)
End If

Remarques

Si l’un des fichiers ou répertoires du tableau change ou est supprimé du tableau, l’élément mis en cache devient obsolète et est supprimé de l’objet de Cache l’application.

En outre, si l’un des répertoires ou fichiers spécifiés dans le filenames paramètre est introuvable dans le système de fichiers, il est traité comme manquant. Si un répertoire ou un fichier est manquant lorsque l’objet avec la dépendance est ajouté à , Cachel’objet mis en cache est supprimé du lors de la Cache création de ce répertoire ou fichier.

Par exemple, supposons que vous ajoutez un objet à avec Cache une dépendance sur le chemin de fichier suivant : c :\stocks\xyz.dat. Si ce fichier est introuvable lors de la création de l’objet CacheDependency , mais qu’il est créé ultérieurement, l’objet mis en cache est supprimé lors de la création du fichier xyz.dat.

Notes

Lorsque vous créez le tableau qui contient les dépendances de fichier, vous devez définir le nombre de fichiers dont dépend l’élément que vous ajoutez à Cache .

Voir aussi

S’applique à

CacheDependency(String, DateTime)

Initialise une nouvelle instance de la classe CacheDependency qui surveille un fichier ou un répertoire pour déceler les modifications.

public:
 CacheDependency(System::String ^ filename, DateTime start);
public CacheDependency (string filename, DateTime start);
new System.Web.Caching.CacheDependency : string * DateTime -> System.Web.Caching.CacheDependency
Public Sub New (filename As String, start As DateTime)

Paramètres

filename
String

Chemin d'accès vers un fichier ou un répertoire dont l'objet mis en cache dépend. Lorsque cette ressource change, l'objet mis en cache devient obsolète et est supprimé du cache.

start
DateTime

Heure par rapport à laquelle vérifier la date de dernière modification du répertoire ou du fichier.

Exemples

L’exemple de code suivant utilise ce constructeur pour instancier un CacheDependency objet, puis insère un élément dans avec Cache cette dépendance. 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 le répertoire ou le fichier spécifié dans le filename paramètre est introuvable dans le système de fichiers, il est traité comme manquant. Si le répertoire ou le fichier est manquant lorsque l’objet avec la dépendance est ajouté à , Cachel’objet mis en cache est supprimé du lors de la Cache création du répertoire ou du fichier.

Par exemple, supposons que vous ajoutez un objet à avec Cache une dépendance sur le chemin de fichier suivant : c :\stocks\xyz.dat. Si ce fichier est introuvable lors de la création de l’objet CacheDependency , mais qu’il est créé ultérieurement, l’objet mis en cache est supprimé lors de la création du fichier xyz.dat.

Notes

Le suivi des modifications commence immédiatement et n’est pas directement basé sur le start paramètre . Utilisez le start paramètre pour passer une date et une heure passées par rapport auxquelles vous souhaitez vérifier la date de dernière modification du répertoire ou du fichier passé dans le filename paramètre. Si la date de la dernière modification est postérieure à la date et à l’heure passées dans le start paramètre, l’élément mis en cache est supprimé de .Cache

Voir aussi

S’applique à

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.

public:
 CacheDependency(cli::array <System::String ^> ^ filenames, DateTime start);
public CacheDependency (string[] filenames, DateTime start);
new System.Web.Caching.CacheDependency : string[] * DateTime -> System.Web.Caching.CacheDependency
Public Sub New (filenames As String(), start As DateTime)

Paramètres

filenames
String[]

Tableau de chemins d'accès (vers des fichiers ou des répertoires) dont dépend l'objet mis en cache. Lorsque l'une de ces ressources change, l'objet mis en cache devient obsolète et est supprimé du cache.

start
DateTime

Heure par rapport à laquelle vérifier la date de dernière modification des objets du tableau.

Exemples

L’exemple de code suivant crée un CacheDependency objet qui transmet deux fichiers XML et une DateTime.Now valeur lorsque l’objet est inclus en tant qu’argument de paramètre dans un appel de Cache.Insert méthode.

// Create a DateTime object that determines
// when dependency monitoring begins.
DateTime dt = DateTime.Now;
    // Make key1 dependent on several files.
    String[] files = new String[2];
    files[0] = Server.MapPath("isbn.xml");
    files[1] = Server.MapPath("customer.xml");
    CacheDependency dep = new CacheDependency(files, dt);

    Cache.Insert("key1", "Value 1", dep);
}
    ' Create a DateTime object that determines
    '  when dependency monitoring begins.
    Dim dt As DateTime = DateTime.Now

    ' Make key1 dependent on several files.
    Dim files(2) as String
    files(0) = Server.MapPath("isbn.xml")
    files(1) = Server.MapPath("customer.xml")
    Dim dependency as new CacheDependency(files, dt)

    Cache.Insert("key1", "Value 1", dependency)
End If

Remarques

Si l’un des répertoires ou fichiers spécifiés dans le filenames paramètre est introuvable dans le système de fichiers, il est traité comme manquant. Si un répertoire ou un fichier est manquant lorsque l’objet avec la dépendance est ajouté à , Cachel’objet mis en cache est supprimé du lors de la Cache création de ce répertoire ou fichier.

Par exemple, supposons que vous ajoutez un objet à avec Cache une dépendance sur le chemin de fichier suivant : c :\stocks\xyz.dat. Si ce fichier est introuvable lors de la création de l’objet CacheDependency , mais qu’il est créé ultérieurement, l’objet mis en cache est supprimé lors de la création du fichier xyz.dat.

Notes

Le suivi des modifications commence immédiatement et n’est pas directement basé sur le start paramètre . Utilisez le start paramètre pour passer une date et une heure dans le passé par rapport auxquelles vous souhaitez vérifier la date de dernière modification du tableau passé dans le filenames paramètre . Si la date de dernière modification d’un objet dans le tableau est postérieure à la date et à l’heure passées dans le start paramètre, l’élément mis en cache est supprimé du Cache.

Voir aussi

S’applique à

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.

public:
 CacheDependency(cli::array <System::String ^> ^ filenames, cli::array <System::String ^> ^ cachekeys);
public CacheDependency (string[] filenames, string[] cachekeys);
new System.Web.Caching.CacheDependency : string[] * string[] -> System.Web.Caching.CacheDependency
Public Sub New (filenames As String(), cachekeys As String())

Paramètres

filenames
String[]

Tableau de chemins d'accès (vers des fichiers ou des répertoires) dont dépend l'objet mis en cache. Lorsque l'une de ces ressources change, l'objet mis en cache devient obsolète et est supprimé du cache.

cachekeys
String[]

Tableau de clés de cache que le nouvel objet surveille pour déceler les modifications. Lorsque l'une de ces clés de cache change, l'objet mis en cache associé à cet objet de dépendance devient obsolète et est supprimé du cache.

Exemples

Le fragment de code suivant montre comment insérer un élément dans votre application Cache avec une dépendance sur une clé d’un autre élément placé dans le cache. Étant donné que cette méthode utilise la syntaxe de tableau, vous devez définir le nombre de clés dont dépend l’élément que vous ajoutez à.Cache

public void CreateDependency(Object sender, EventArgs e) {
    // Create a cache entry.
    Cache["key1"] = "Value 1";

    // Make key2 dependent on key1.
    String[] dependencyKey = new String[1];
    dependencyKey[0] = "key1";
    CacheDependency dependency = new CacheDependency(null, dependencyKey);

    Cache.Insert("key2", "Value 2", dependency);

    DisplayValues();
}
Public Sub CreateDependency(sender As Object, e As EventArgs)
    ' Create a cache entry.
    Cache("key1") = "Value 1"

    ' Make key2 dependent on key1.
    Dim dependencyKey(0) As String
    dependencyKey(0) = "key1"
    Dim dependency As new CacheDependency(Nothing, dependencyKey)

    Cache.Insert("key2", "Value 2", dependency)

    DisplayValues()
End Sub

Remarques

En outre, si l’un des répertoires ou fichiers spécifiés dans le filenames paramètre est introuvable dans le système de fichiers, il est traité comme manquant. Si un répertoire ou un fichier est manquant lorsque l’objet avec la dépendance est ajouté à , Cachel’objet mis en cache est supprimé du lors de la Cache création de ce répertoire ou fichier.

Par exemple, supposons que vous ajoutez un objet à avec Cache une dépendance sur le chemin de fichier suivant : c :\stocks\xyz.dat. Si ce fichier est introuvable lors de la création de l’objet CacheDependency , mais qu’il est créé ultérieurement, l’objet mis en cache est supprimé lors de la création du fichier xyz.dat.

Toutefois, la cachekeys dépendance ne fonctionne pas de la même façon. Si au moins une valeur dans le cachekeys paramètre n’existe pas au moment d’une insertion, l’insertion échoue. Notez qu’aucune exception n’est levée pour ce scénario.

Voir aussi

S’applique à

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.

public:
 CacheDependency(cli::array <System::String ^> ^ filenames, cli::array <System::String ^> ^ cachekeys, DateTime start);
public CacheDependency (string[] filenames, string[] cachekeys, DateTime start);
new System.Web.Caching.CacheDependency : string[] * string[] * DateTime -> System.Web.Caching.CacheDependency
Public Sub New (filenames As String(), cachekeys As String(), start As DateTime)

Paramètres

filenames
String[]

Tableau de chemins d'accès (vers des fichiers ou des répertoires) dont dépend l'objet mis en cache. Lorsque l'une de ces ressources change, l'objet mis en cache devient obsolète et est supprimé du cache.

cachekeys
String[]

Tableau de clés de cache que le nouvel objet surveille pour déceler les modifications. Lorsque l'une de ces clés de cache change, l'objet mis en cache associé à cet objet de dépendance devient obsolète et est supprimé du cache.

start
DateTime

Date et heure par rapport auxquelles vérifier la date de dernière modification des objets passés dans les tableaux filenames et cachekeys.

Exemples

L’exemple de code suivant crée une CreateDependency méthode. Lorsque cette méthode est appelée, elle crée un DateTime objet et la Cache.Item[] propriété est utilisée pour ajouter un élément au cache avec un key paramètre et key1 une valeur de Value 1. Un tableau de chaînes, dependencyKey, est ensuite créé avec la valeur de key1 . Ce CacheDependency constructeur instancie ensuite un CacheDependency objet qui passe dependencyKey et l’objet DateTime en tant qu’arguments de paramètre. La Cache.Insert méthode est appelée suivant, en utilisant l’objet CacheDependency comme paramètre. Cela rend l’objet ajouté au cache à l’aide de la Insert méthode dépendant de la key1 clé.

public void CreateDependency(Object sender, EventArgs e)
{
    // Create a DateTime object.
    DateTime dt = DateTime.Now.AddSeconds(10);

    // Create a cache entry.
    Cache["key1"] = "Value 1";

    // Make key2 dependent on key1.
    String[] dependencyKey = new String[1];
    dependencyKey[0] = "key1";
    CacheDependency dependency = new CacheDependency(null, dependencyKey, dt);

    Cache.Insert("key2", "Value 2", dependency);

    DisplayValues();
}
Public Sub CreateDependency(sender As Object, e As EventArgs)
' Create a DateTime object.
Dim dt as DateTime = DateTime.Now.AddSeconds(10)        

' Create a cache entry.
    Cache("key1") = "Value 1"

    ' Make key2 dependent on key1.
    Dim dependencyKey(0) As String
    dependencyKey(0) = "key1"
    Dim dependency As new CacheDependency(Nothing, dependencyKey, dt)

    Cache.Insert("key2", "Value 2", dependency)

    DisplayValues()
End Sub

Remarques

En outre, si l’un des répertoires ou fichiers spécifiés dans le filenames paramètre est introuvable dans le système de fichiers, il est traité comme manquant. Si un répertoire ou un fichier est manquant lorsque l’objet avec la dépendance est ajouté à , Cachel’objet mis en cache est supprimé du lors de la Cache création de ce répertoire ou fichier.

Par exemple, supposons que vous ajoutez un objet à avec Cache une dépendance sur le chemin de fichier suivant : c :\stocks\xyz.dat. Si ce fichier est introuvable lors de la création de l’objet CacheDependency , mais qu’il est créé ultérieurement, l’objet mis en cache est supprimé lors de la création du fichier xyz.dat.

Toutefois, la cachekeys dépendance ne fonctionne pas de la même façon. Si au moins une valeur dans le cachekeys paramètre n’existe pas au moment d’une insertion, l’insertion échoue. Notez qu’aucune exception n’est levée pour ce scénario.

Notes

Le suivi des modifications commence immédiatement et n’est pas directement basé sur le start paramètre . Utilisez le start paramètre pour passer une date et une heure passées par rapport auxquelles vous souhaitez vérifier la date de dernière modification d’un objet passé dans les filenames paramètres ou cachekeys . Si la date de la dernière modification de l’un de ces objets est postérieure à la date et à l’heure passées dans le start paramètre, l’élément mis en cache est supprimé de .Cache

Voir aussi

S’applique à

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.

public:
 CacheDependency(cli::array <System::String ^> ^ filenames, cli::array <System::String ^> ^ cachekeys, System::Web::Caching::CacheDependency ^ dependency);
public CacheDependency (string[] filenames, string[] cachekeys, System.Web.Caching.CacheDependency dependency);
new System.Web.Caching.CacheDependency : string[] * string[] * System.Web.Caching.CacheDependency -> System.Web.Caching.CacheDependency
Public Sub New (filenames As String(), cachekeys As String(), dependency As CacheDependency)

Paramètres

filenames
String[]

Tableau de chemins d'accès (vers des fichiers ou des répertoires) dont dépend l'objet mis en cache. Lorsque l'une de ces ressources change, l'objet mis en cache devient obsolète et est supprimé du cache.

cachekeys
String[]

Tableau de clés de cache que le nouvel objet surveille pour déceler les modifications. Lorsque l'une de ces clés de cache change, l'objet mis en cache associé à cet objet de dépendance devient obsolète et est supprimé du cache.

dependency
CacheDependency

Une autre instance de la classe CacheDependency dont cette instance dépend.

Exemples

L’exemple de code suivant crée une CreateDependency méthode. Lorsque cette méthode est appelée, elle utilise la Cache.Item[] propriété pour ajouter un élément au cache avec un key paramètre et key1 une valeur de Value 1. Un tableau de chaînes, dependencyKey, est ensuite créé avec la valeur de key1 . Le CacheDependency.CacheDependency constructeur est utilisé pour créer un CacheDependency objet, dep1, qui passe dependencyKey en tant qu’argument de paramètre. Un deuxième CacheDependency objet, dep2, est créé à l’aide de ce constructeur, avec dep1 passé comme troisième argument de paramètre. Cette deuxième dépendance dépend de la première. La Cache.Insert méthode est appelée next, en utilisant le deuxième CacheDependency objet comme paramètre. Si la première dépendance change d’une manière ou d’une autre, l’élément mis en cache est invalidé.

public void CreateDependency(Object sender, EventArgs e) {
    // Create a cache entry.
    Cache["key1"] = "Value 1";

    // Make key2 dependent on key1.
    String[] dependencyKey = new String[1];
    dependencyKey[0] = "key1";
    CacheDependency dep1 = new CacheDependency(null, dependencyKey);

    // Make a second CacheDependency dependent on dep1.        
    CacheDependency dep2 = new CacheDependency(null, null, dep1);

    Cache.Insert("key2", "Value 2", dep2);

    DisplayValues();
}
 Public Sub CreateDependency(sender As [Object], e As EventArgs)
   ' Create a cache entry.
   Cache("key1") = "Value 1"

   ' Make key2 dependent on key1 using double dependency.
   Dim dependencyKey(0) As [String]
   dependencyKey(0) = "key1"
   Dim dep1 As New CacheDependency(Nothing, dependencyKey)

   ' Make a second CacheDependency dependent on dep1.        
   Dim dep2 As New CacheDependency(Nothing, Nothing, dep1)

   Cache.Insert("key2", "Value 2", dep2)

   DisplayValues()
End Sub 'CreateDependency

Remarques

En outre, si l’un des répertoires ou fichiers spécifiés dans le filenames paramètre est introuvable dans le système de fichiers, il est traité comme manquant. Si un répertoire ou un fichier est manquant lorsque l’objet avec la dépendance est ajouté à , Cachel’objet mis en cache est supprimé du lors de la Cache création de ce répertoire ou fichier.

Par exemple, supposons que vous ajoutez un objet à avec Cache une dépendance sur le chemin de fichier suivant : c :\stocks\xyz.dat. Si ce fichier est introuvable lors de la création de l’objet CacheDependency , mais qu’il est créé ultérieurement, l’objet mis en cache est supprimé lors de la création du fichier xyz.dat.

Toutefois, la cachekeys dépendance ne fonctionne pas de la même façon. Si au moins une valeur dans le cachekeys paramètre n’existe pas au moment d’une insertion, l’insertion échoue. Notez qu’aucune exception n’est levée pour ce scénario.

S’applique à

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.

public:
 CacheDependency(cli::array <System::String ^> ^ filenames, cli::array <System::String ^> ^ cachekeys, System::Web::Caching::CacheDependency ^ dependency, DateTime start);
public CacheDependency (string[] filenames, string[] cachekeys, System.Web.Caching.CacheDependency dependency, DateTime start);
new System.Web.Caching.CacheDependency : string[] * string[] * System.Web.Caching.CacheDependency * DateTime -> System.Web.Caching.CacheDependency
Public Sub New (filenames As String(), cachekeys As String(), dependency As CacheDependency, start As DateTime)

Paramètres

filenames
String[]

Tableau de chemins d'accès (vers des fichiers ou des répertoires) dont dépend l'objet mis en cache. Lorsque l'une de ces ressources change, l'objet mis en cache devient obsolète et est supprimé du cache.

cachekeys
String[]

Tableau de clés de cache que le nouvel objet surveille pour déceler les modifications. Lorsque l'une de ces clés de cache change, l'objet mis en cache associé à cet objet de dépendance devient obsolète et est supprimé du cache.

dependency
CacheDependency

Une autre instance de la classe CacheDependency dont cette instance dépend.

start
DateTime

Heure par rapport à laquelle vérifier la date de dernière modification des objets dans les tableaux et l'objet CacheDependency.

Exemples

L’exemple de code suivant montre une CreateDependency méthode . Lorsque cette méthode est appelée, elle crée un DateTime objet et la Cache.Item[] propriété est utilisée pour ajouter un élément au cache avec un paramètre de clé et key1 une valeur de Value 1. Un tableau de chaînes, dependencyKey, est ensuite créé avec la valeur à son premier (et seul) index défini sur la valeur de key1 . Le CacheDependency.CacheDependency constructeur est ensuite utilisé pour créer un CacheDependency objet, dep1, qui passe dependencyKey en tant qu’argument de paramètre. Un deuxième CacheDependency objet, dep2, est ensuite créé à l’aide de ce constructeur, avec dep1 et l’objet DateTime passé en tant qu’arguments de paramètre. Cette deuxième dépendance dépend de la première, et la surveillance des dépendances commence 10 secondes après l’appel de la CreateDependency méthode. La Cache.Insert méthode est appelée next, en utilisant le deuxième CacheDependency objet comme paramètre. Si la première dépendance change d’une manière ou d’une autre, l’élément mis en cache est invalidé.

public void CreateDependency(Object sender, EventArgs e) {
    // Create a DateTime object.
    DateTime dt = DateTime.Now.AddSeconds(10);

    // Create a cache entry.
    Cache["key1"] = "Value 1";

    // Make key2 dependent on key1.
    String[] dependencyKey = new String[1];
    dependencyKey[0] = "key1";
    CacheDependency dep1 = new CacheDependency(null, dependencyKey);

    // Make a second CacheDependency dependent on dep1.
    // and use dt to start change monitoring.        
    CacheDependency dep2 = new CacheDependency(null, null, dep1, dt);

    Cache.Insert("key2", "Value 2", dep2);

    DisplayValues();
}
 Public Sub CreateDependency(sender As [Object], e As EventArgs)
   ' Create a DateTime object.
   Dim dt as DateTime = DateTime.Now.AddSeconds(10)        

   ' Create a cache entry.
   Cache("key1") = "Value 1"

   ' Make key2 dependent on key1 using double dependency.
   Dim dependencyKey(0) As [String]
   dependencyKey(0) = "key1"
   Dim dep1 As New CacheDependency(Nothing, dependencyKey)

   ' Make a second CacheDependency dependent on dep1
   ' and use dt to start change monitoring.        
   Dim dep2 As New CacheDependency(Nothing, Nothing, dep1, dt)

   Cache.Insert("key2", "Value 2", dep2)

   DisplayValues()
End Sub 'CreateDependency

Remarques

En outre, si l’un des répertoires ou fichiers spécifiés dans le filenames paramètre est introuvable dans le système de fichiers, il est traité comme manquant. Si un répertoire ou un fichier est manquant lorsque l’objet avec la dépendance est ajouté à , Cachel’objet mis en cache est supprimé du lors de la Cache création de ce répertoire ou fichier.

Par exemple, supposons que vous ajoutez un objet à avec Cache une dépendance sur le chemin de fichier suivant : c :\stocks\xyz.dat. Si ce fichier est introuvable lors de la création de l’objet CacheDependency , mais qu’il est créé ultérieurement, l’objet mis en cache est supprimé lors de la création du fichier xyz.dat.

Toutefois, la cachekeys dépendance ne fonctionne pas de la même façon. Si au moins une valeur dans le cachekeys paramètre n’existe pas au moment d’une insertion, l’insertion échoue. Notez qu’aucune exception n’est levée pour ce scénario.

Notes

Le suivi des modifications commence immédiatement et n’est pas directement basé sur le start paramètre . Utilisez le start paramètre pour passer une date et une heure dans le passé par rapport auxquelles vous souhaitez vérifier la date de dernière modification de l’un des objets passés dans les filenamesparamètres , cachekeysou dependency . Si la date de la dernière modification de l’un de ces objets est postérieure à la date et à l’heure passées dans le start paramètre, l’élément mis en cache est supprimé du Cache.

Voir aussi

S’applique à