CachingSection-Klasse

Artikel
03/28/2024

Konfiguriert die Ausgabe- und Kernelzwischenspeicherung.

Syntax

class CachingSection : ConfigurationSectionWithCollection

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der CachingSection-Klasse verfügbar gemacht werden.

Name	Beschreibung
Add (Hinzufügen)	(Geerbt von ConfigurationSectionWithCollection.)
Clear	(Geerbt von `ConfigurationSectionWithCollection`.)
Get	(Geerbt von `ConfigurationSectionWithCollection`.)
GetAllowDefinition	(Geerbt von ConfigurationSection.)
GetAllowLocation	(Geerbt von `ConfigurationSection`.)
Remove	(Geerbt von `ConfigurationSectionWithCollection`.)
RevertToParent	(Geerbt von `ConfigurationSection`.)
SetAllowDefinition	(Geerbt von `ConfigurationSection`.)
SetAllowLocation	(Geerbt von `ConfigurationSection`.)

Eigenschaften

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die von der CachingSection Klasse verfügbar gemacht werden.

Name	Beschreibung
`Enabled`	Ein Lese-/Schreibwert `boolean`. `true`, wenn der Ausgabecache aktiviert ist; andernfalls `false`. Wenn der Ausgabecache deaktiviert ist, tritt keine Zwischenspeicherung der Antwortausgabe oder Kernelzwischenspeicherung auf. Der Standardwert ist `true`.
`EnableKernelCache`	Ein Lese-/Schreibwert `boolean`. `true`, wenn die Kernelzwischenspeicherung aktiviert ist, andernfalls `false`. Der Standardwert ist `true`.
`Location`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`MaxCacheSize`	Ein Lese-/Schreibwert `uint32`, der die maximale Größe des Ausgabecaches in Megabyte angibt. Der Standardwert ist 0. Der Wert 0 bedeutet, dass die Cachespeichergröße automatisch verwaltet wird. Eine Größe von `MaxValue` bedeutet, dass es keine Beschränkung für die Cachegröße gibt. Hinweis: Diese Einstellung ist nur auf der Ebene der ApplicationHost.config-Datei wirksam. Wenn Sie diese Eigenschaft auf einer niedrigeren Ebene festlegen, hat sie keine Auswirkung.
`MaxResponseSize`	Ein Lese-/Schreibwert `uint32`, der die maximale Größe einer Antwort in Bytes angibt, die im Ausgabecache gespeichert werden kann. Der Standardwert ist 262144 (256 KB). Eine Einstellung von 0 bedeutet keine Beschränkung. Hinweis: Diese Einstellung ist nur auf der Ebene der ApplicationHost.config-Datei wirksam. Wenn Sie diese Eigenschaft auf einer niedrigeren Ebene festlegen, hat sie keine Auswirkung.
`Path`	(Geerbt von `ConfigurationSection`.) Eine Schlüsseleigenschaft.
`Profiles`	Ein CachingProfileSettings-Wert, der die Zwischenspeicherung für bestimmte Anforderungserweiterungen konfiguriert.
`SectionInformation`	(Geerbt von `ConfigurationSection`.)

Unterklassen

Diese Klasse enthält keine Unterklassen.

Beispiel

Im folgenden Beispiel werden Eigenschaften im CachingSection-Objekt für die Standardwebsite angezeigt, einschließlich der CachingProfileSettings-Werte in der Profiles Array-Eigenschaft. Es werden zwei Hilfsfunktionen bereitgestellt, um Text für die Enumerationen Policy, KernelCachePolicyund Location anzuzeigen.

' 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

Vererbungshierarchie

ConfigurationSection

ConfigurationSectionWithCollection

CachingSection

Anforderungen

type	Beschreibung
Client	- IIS 7.0 unter Windows Vista IIS 7.5 unter Windows 7 IIS 8.0 unter Windows 8 IIS 10.0 unter Windows 10
Server	IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 IIS 8.0 auf Windows Server 2012. - IIS 8.5 unter Windows Server 2012 R2 IIS 10.0 auf Windows Server 2016.
Produkt	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei	WebAdministration.mof

Weitere Informationen

AspCache-Klasse
CachingProfileElement-Klasse
CachingProfileSettings-Klasse
ConfigurationSection-Klasse
ConfigurationSectionWithCollection-Klasse
HttpClientCache-Klasse

Freigeben über