Partager via


Classe CachingProfileElement

Configure la mise en cache d’une extension de requête donnée.

Syntaxe

class CachingProfileElement : CollectionElement  

Méthodes

Cette classe ne contient pas de méthodes.

Propriétés

Le tableau suivant répertorie les propriétés présentées par la classe CachingProfileElement.

Nom Description
Duration Valeur datetime en lecture/écriture qui définit la durée pendant laquelle une réponse doit rester dans le cache. La valeur par défaut est 30 secondes. L’intervalle de temps valide est compris entre 0 et 365 jours.
Extension Valeur string unique en lecture/écriture requise qui définit l’extension d’une requête qui utilisera le profil de cache. L’extension doit être au format « EXT » ou « * », où EXT est l’extension. La propriété clé. Remarque : Aucune entrée d’extension qui se chevauche n’est autorisée. Chaque requête est mappée à un seul objet CachingProfileElement. Si une entrée avec un « * » existe, d’autres profils de mise en cache avec des extensions plus spécifiques remplacent le profil par l’astérisque. L’ordre des entrées de profil n’est pas important.
KernelCachePolicy Valeur sint32 en lecture/écriture qui configure la stratégie de mise en cache du noyau. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
Location Valeur sint32 en lecture/écriture qui définit les emplacements possibles pour le cache de sortie. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
Policy Valeur sint32 en lecture/écriture qui configure la stratégie de mise en cache de sortie. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
VaryByHeaders Valeur string en lecture/écriture qui contient une liste délimitée par des virgules de noms d’en-tête que le serveur utilisera pour varier les réponses mises en cache à l’URL.
VaryByQueryString Valeur string en lecture/écriture qui contient une liste délimitée par des virgules de noms de paramètres de chaîne de requête que le serveur utilisera pour varier les réponses mises en cache à l’URL.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Cette classe correspond à l’élément <profiles> sous la section <system.webServer/caching> du fichier ApplicationHost.config. Les instances de cette classe sont contenues dans la propriété tableau Profiles de la classe CachingProfileSettings.

Le tableau suivant répertorie les valeurs possibles pour la propriété KernelCachePolicy. La valeur par défaut est 0 (DontCache).

Valeur Mot clé Description
0 DontCache La réponse ne sera pas mise en cache dans le noyau. Toutefois, la mise en cache de sortie peut toujours se produire. Remarque : Ce paramètre remplace les paramètres en conflit dans la propriété Location.
1 CacheUntilChange La réponse est mise en cache dans le cache HTTP.SYS jusqu’à ce que l’entrée soit invalidée ou jusqu’à ce qu’elle expire après la période d’inactivité définie par la propriété Duration.
2 CacheForTimePeriod La réponse est mise en cache pendant la durée définie par la propriété Duration, même si l’entrée est invalidée dans l’intervalle.
3 DisableCache Le cache est désactivé et aucune mise en cache ne se produit.

Le tableau suivant répertorie les valeurs possibles pour la propriété Location. La valeur par défaut est 3 (Server).

Valeur Mot clé Description
0 Any La réponse peut être mise en cache sur le client, le serveur internet ou le serveur proxy.
1 Client La réponse est mise en cache uniquement sur le client.
2 Downstream La réponse est mise en cache sur les serveurs proxy et sur le client, mais pas sur le serveur internet.
3 Server La réponse est mise en cache uniquement sur le serveur internet.
4 None La réponse n’est pas mise en cache n’importe où.
5 ServerAndClient La réponse est mise en cache sur le serveur internet et le client, mais pas sur les serveurs proxy. Remarque : Vous pouvez utiliser ce paramètre pour éviter de partager du contenu entre plusieurs utilisateurs sur des caches proxy lorsque le serveur a un comportement variable pour le contenu privé.

Le tableau suivant répertorie les valeurs possibles pour la propriété Policy. La valeur par défaut est 0 (DontCache).

Valeur Mot clé Description
0 DontCache La réponse ne sera pas placée dans le cache de sortie. Toutefois, la mise en cache du noyau peut toujours se produire.
1 CacheUntilChange La réponse est mise en cache jusqu’à ce que l’entrée soit invalidée ou jusqu’à ce qu’elle expire après la période d’inactivité définie par la propriété Duration.
2 CacheForTimePeriod La réponse est mise en cache pendant la durée définie par la propriété Duration, même si l’entrée est invalidée dans l’intervalle.
3 DisableCache Le cache est désactivé et aucune mise en cache ne se produit.

Exemple

L’exemple suivant affiche tous les objets CachingProfileElement du site internet par défaut.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the caching section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "CachingSection", oSection  

' Display the path and location.  
Wscript.Echo "Path: " & oSection.Path  
Wscript.Echo "Location: " & oSection.Location  
Wscript.Echo

' Display all of the caching profiles for the default Web site.  
For Each oCachingProfileElement In oSection.Profiles.Profiles  
    Wscript.Echo
    WScript.Echo "[ " & oCachingProfileElement.Extension & _  
        " ] Caching Profile"  
    WScript.Echo "-----------------------------------"  
    WScript.Echo "Duration: " & oCachingProfileElement.Duration  
    WScript.Echo "KernelCachePolicy: " & _  
        CachePolicyText(oCachingProfileElement.KernelCachePolicy)  
    WScript.Echo "Location: " & _  
        LocationText(oCachingProfileElement.Location)  
    WScript.Echo "Policy: " & _  
        CachePolicyText(oCachingProfileElement.Policy)  
    WScript.Echo "VaryByHeaders: " & _  
        oCachingProfileElement.VaryByHeaders  
    WScript.Echo "VaryByQueryString: " & _  
        oCachingProfileElement.VaryByQueryString  
    WScript.Echo
Next  

' Provide text for KernelCachePolicy and Policy enumeration values.  
Function CachePolicyText(enumval)  

    Select Case enumval  
        Case 0  
            CachePolicyText="DontCache"  
        Case 1  
            CachePolicyText="CacheUntilChange"  
        Case 2  
            CachePolicyText="CacheForTimePeriod"  
        Case 3  
            CachePolicyText="DisableCache"  
        Case Else  
            CachePolicyText="Undefined enumeration value"  
    End Select  

End Function  

' Provide text for Location enumeration values.  
Function LocationText(enumval)  

    Select Case enumval  
        Case 0  
            LocationText="Any"  
        Case 1  
            LocationText="Client"  
        Case 2  
            GetLocationText="Downstream"  
        Case 3  
            LocationText="Server"  
        Case 4  
            LocationText="None"  
        Case 5  
            LocationText="ServerAndClient"  
        Case Else  
            LocationText="Undefined enumeration value"  
    End Select  

End Function

Hiérarchie d'héritage

CollectionElement

CachingProfileElement

Spécifications

Type Description
Client - IIS 7.0 sous Windows Vista
- IIS 7.5 sous Windows 7
- IIS 8.0 sous Windows 8
- IIS 10.0 sous Windows 10
Serveur - IIS 7.0 sous Windows Server 2008
- IIS 7.5 sous Windows Server 2008 R2
- IIS 8.0 sous Windows Server 2012
- IIS 8.5 sous Windows Server 2012 R2
- IIS 10.0 sous Windows Server 2016
Produit - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF WebAdministration.mof

Voir aussi

Classe AspCache
Classe CachingProfileSettings
Classe CachingSection
Classe CollectionElement
Classe HttpClientCache