CacheDependency Constructeurs
Définition
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.
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 filenames
paramètres , cachekeys
ou 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.