Classe CachingSection

Article
03/20/2024

Configure la sortie et la mise en cache du noyau.

Syntaxe

class CachingSection : ConfigurationSectionWithCollection

Méthodes

Le tableau suivant répertorie les méthodes exposées par la classe CachingSection.

Nom	Description
Ajouter	(Hérité de ConfigurationSectionWithCollection.)
Clear	(Hérité de `ConfigurationSectionWithCollection`.)
Get	(Hérité de `ConfigurationSectionWithCollection`.)
GetAllowDefinition	(Hérité de ConfigurationSection.)
GetAllowLocation	(Hérité de `ConfigurationSection`.)
Remove	(Hérité de `ConfigurationSectionWithCollection`.)
RevertToParent	(Hérité de `ConfigurationSection`.)
SetAllowDefinition	(Hérité de `ConfigurationSection`.)
SetAllowLocation	(Hérité de `ConfigurationSection`.)

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe CachingSection.

Nom	Description
`Enabled`	Une valeur `boolean` en lecture/écriture. `true` si le cache de sortie est activé ; sinon, `false`. Si le cache de sortie est désactivé, aucune mise en cache de sortie de réponse ou mise en cache du noyau ne se produit. Par défaut, il s’agit de `true`.
`EnableKernelCache`	Une valeur `boolean` en lecture/écriture. `true` si la mise en cache de sortie est activée ; sinon, `false`. Par défaut, il s’agit de `true`.
`Location`	(Hérité de `ConfigurationSection`.) Une propriété clé.
`MaxCacheSize`	Valeur `uint32` en lecture/écriture qui spécifie la taille maximale, en mégaoctets, du cache de sortie. La valeur par défaut est 0. La valeur 0 signifie que la taille de mémoire du cache est gérée automatiquement. Une taille de `MaxValue` signifie qu’il n’existe aucune limite sur la taille du cache. Remarque : Ce paramètre est effectif uniquement au niveau du fichier ApplicationHost.config. Si vous définissez cette propriété à un niveau inférieur, elle n’aura aucun effet.
`MaxResponseSize`	Valeur `uint32` en lecture/écriture qui définit la taille maximale, en octets, d’une réponse qui peut être stockée dans le cache de sortie. La valeur par défaut est 262144 (256 Ko). Un paramètre de 0 signifie qu’aucune limite n’est définie. Remarque : Ce paramètre est effectif uniquement au niveau du fichier ApplicationHost.config. Si vous définissez cette propriété à un niveau inférieur, elle n’aura aucun effet.
`Path`	(Hérité de `ConfigurationSection`.) Une propriété clé.
`Profiles`	Valeur CachingProfileSettings qui configure la mise en cache pour des extensions de requête spécifiques.
`SectionInformation`	(Hérité de `ConfigurationSection`.)

Sous-classes

Cette classe ne contient aucune sous-classe.

Exemple

L’exemple suivant affiche les propriétés de l’objet CachingSection pour le site internet par défaut, y compris les valeurs CachingProfileSettings de la propriété de tableau Profiles. Deux fonctions d’assistance sont fournies pour afficher du texte pour les énumérations Policy, KernelCachePolicy et Location.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the CachingSection 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 other non-array CachingSection properties.  
WScript.Echo "Enabled: " & oSection.Enabled  
Wscript.Echo "EnableKernelCache: " & oSection.EnableKernelCache  
Wscript.Echo "MaxCacheSize: " & oSection.MaxCacheSize  
Wscript.Echo "MaxResponseSize: " & oSection.MaxResponseSize  
Wscript.Echo   
  
' Display the caching profiles from the Profiles property.  
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 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

ConfigurationSection

ConfigurationSectionWithCollection

CachingSection

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 CachingProfileElement
Classe CachingProfileSettings
Classe ConfigurationSection
Classe ConfigurationSectionWithCollection
Classe HttpClientCache

Partager via