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