CacheItemPolicy Classe

Définition

Représente un jeu de détails d'éviction et d'expiration pour une entrée de cache spécifique.

public ref class CacheItemPolicy
public class CacheItemPolicy
type CacheItemPolicy = class
Public Class CacheItemPolicy
Héritage
CacheItemPolicy

Exemples

L’exemple suivant montre comment créer un élément de cache en mémoire qui surveille le chemin d’accès d’un fichier texte. Le cache crée un CacheItemPolicy objet et définit la AbsoluteExpiration propriété pour qu’elle supprime le cache après 60 secondes.

Protected Sub Button1_Click(ByVal sender As Object, _  
            ByVal e As System.EventArgs) Handles Button1.Click  
    Dim cache As ObjectCache = MemoryCache.Default  
    Dim fileContents As String = TryCast(cache("filecontents"), _  
            String)  
    If fileContents Is Nothing Then  
        Dim policy As New CacheItemPolicy()  
        policy.AbsoluteExpiration = _  
            DateTimeOffset.Now.AddSeconds(60.0)  
        Dim filePaths As New List(Of String)()  
     Dim cachedFilePath As String = Server.MapPath("~") & _  
         "\cacheText.txt"  
        filePaths.Add(cachedFilePath)  
        policy.ChangeMonitors.Add(New _  
            HostFileChangeMonitor(filePaths))  

        ' Fetch the file contents.  
        fileContents = File.ReadAllText(cachedFilePath)  
        cache.Set("filecontents", fileContents, policy)  
    End If  
    Label1.Text = fileContents  
End Sub  
protected void Button1_Click(object sender, EventArgs e)  
    {  
        ObjectCache cache = MemoryCache.Default;  
            string fileContents = cache["filecontents"] as string;  
            if (fileContents == null)  
            {  
                CacheItemPolicy policy = new CacheItemPolicy();  
                policy.AbsoluteExpiration =   
                    DateTimeOffset.Now.AddSeconds(60.0);  

                List<string> filePaths = new List<string>();  
             string cachedFilePath = Server.MapPath("~") +   
                 "\\cacheText.txt";  
             filePaths.Add(cachedFilePath);  

                policy.ChangeMonitors.Add(new   
                    HostFileChangeMonitor(filePaths));  

                // Fetch the file contents.  
                fileContents = File.ReadAllText(cachedFilePath);  

                cache.Set("filecontents", fileContents, policy);  

            }  

            Label1.Text = fileContents;  
        }  

Remarques

Un CacheItemPolicy instance contient des informations qui peuvent être associées à une entrée de cache. Par exemple, lorsqu’une entrée de cache est sur le point d’être supprimée du cache, un CacheEntryUpdateArguments objet est passé à une méthode de rappel. La UpdatedCacheItemPolicy propriété de l’objet CacheEntryUpdateArguments peut transmettre une référence à un CacheItemPolicy instance qui peut inclure des détails d’éviction et d’expiration sur l’entrée du cache.

Certaines méthodes des MemoryCache classes et ObjectCache acceptent une CacheItemPolicy instance pour décrire une stratégie d’éviction ou d’expiration.

Notes pour les héritiers

Le CacheItemPolicy type n’est pas scellé afin que les développeurs de cache personnalisés puissent l’étendre.

Constructeurs

CacheItemPolicy()

Initialise une nouvelle instance de la classe CacheItemPolicy.

Propriétés

AbsoluteExpiration

Obtient ou définit une valeur qui indique si une entrée du cache doit être exclue à un point donné dans le temps.

ChangeMonitors

Obtient une collection d'objets ChangeMonitor associés à une entrée du cache.

Priority

Obtient ou définit un paramètre de priorité utilisé pour déterminer s'il faut supprimer une entrée du cache.

RemovedCallback

Obtient ou définit une référence à un délégué CacheEntryRemovedCallback appelé après la suppression d'une entrée du cache.

SlidingExpiration

Obtient ou définit une valeur qui indique si une entrée du cache doit être évincée, si elle n'a pas été consultée dans un intervalle de temps donné.

UpdateCallback

Obtient ou définit une référence à un délégué CacheEntryUpdateCallback appelé avant la suppression d'une entrée du cache.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
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)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à