CachingSection-Klasse

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