CachingProfileElement-Klasse

Artikel
03/25/2024

Konfiguriert die Zwischenspeicherung für eine bestimmte Anforderungserweiterung.

Syntax

class CachingProfileElement : CollectionElement

Methoden

Diese Klasse enthält keine Methoden.

Eigenschaften

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

Name	Beschreibung
`Duration`	Ein Lese-/Schreibwert `datetime`, der angibt, wie lange eine Antwort im Cache verbleiben soll. Der Standardwert ist 30 Sekunden. Der gültige Zeitraum liegt zwischen 0 und 365 Tagen.
`Extension`	Ein erforderlicher eindeutiger Lese-/Schreibwert `string`, der die Erweiterung einer Anforderung angibt, die das Cacheprofil verwendet. Die Erweiterung muss sich in der Form „EXT“ oder „“ befinden, wobei EXT* die Erweiterung ist. Die Schlüsseleigenschaft. Hinweis: Es sind keine überlappenden Erweiterungseinträge zulässig. Jede Anforderung ist genau einem `CachingProfileElement`-Objekt zugeordnet. Wenn ein Eintrag mit einem „*“ vorhanden ist, überschreiben andere Zwischenspeicherungsprofile mit spezifischeren Erweiterungen das Profil mit dem Sternchen. Die Sortierung von Profileinträgen ist nicht wichtig.
`KernelCachePolicy`	Ein Lese-/Schreibwert `sint32`, der die Kernelzwischenspeicherungsrichtlinie konfiguriert. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`Location`	Ein Lese-/Schreibwert `sint32`, der mögliche Speicherorte für den Ausgabecache angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`Policy`	Ein Lese-/Schreibwert `sint32`, der die Ausgabezwischenspeicherungsrichtlinie konfiguriert. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
`VaryByHeaders`	Ein Lese-/Schreibwert `string`, der eine durch Trennzeichen getrennte Liste von Headernamen enthält, die der Server verwendet, um zwischengespeicherte Antworten auf die URL zu variieren.
`VaryByQueryString`	Ein Lese-/Schreibwert `string`, der eine durch Trennzeichen getrennte Liste der Namen von Abfragezeichenfolgenparametern enthält, die der Server verwendet, um zwischengespeicherte Antworten auf die URL zu variieren.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Diese Klasse entspricht dem <profiles>-Element unter dem <system.webServer/caching>-Abschnitt in der Datei ApplicationHost.config. Instanzen dieser Klasse sind in der Profiles-Array-Eigenschaft der CachingProfileSettings-Klasse enthalten.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die KernelCachePolicy-Eigenschaft angezeigt. Der Standardwert ist 0 (DontCache).

Wert	Schlüsselwort	Beschreibung
0	`DontCache`	Die Antwort wird nicht im Kernel zwischengespeichert. Die Ausgabezwischenspeicherung kann jedoch weiterhin auftreten. Hinweis: Diese Einstellung setzt alle in Konflikt stehenden Einstellungen in der `Location`-Eigenschaft außer Kraft.
1	`CacheUntilChange`	Die Antwort wird im HTTP.SYS Cache zwischengespeichert, bis der Eintrag ungültig ist oder bis er nach dem Zeitraum der in der `Duration`-Eigenschaft angegebenen Inaktivität abläuft.
2	`CacheForTimePeriod`	Die Antwort wird für die von der `Duration`-Eigenschaft angegebene Zeitspanne zwischengespeichert, auch wenn der Eintrag in der Zwischenzeit ungültig ist.
3	`DisableCache`	Der Cache ist deaktiviert, und es tritt keine Zwischenspeicherung auf.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die Location-Eigenschaft angezeigt. Der Standardwert ist 3 (Server).

Wert	Schlüsselwort	Beschreibung
0	`Any`	Die Antwort kann auf dem Client-, Webserver- oder Proxyserver zwischengespeichert werden.
1	`Client`	Die Antwort wird nur auf dem Client zwischengespeichert.
2	`Downstream`	Die Antwort wird auf Proxyservern und auf dem Client zwischengespeichert, aber nicht auf dem Webserver.
3	`Server`	Die Antwort wird nur auf dem Webserver zwischengespeichert.
4	`None`	Die Antwort wird nirgendwo zwischengespeichert.
5	`ServerAndClient`	Die Antwort wird sowohl auf dem Webserver als auch auf dem Client zwischengespeichert, jedoch nicht auf Proxyservern. Hinweis: Sie können diese Einstellung verwenden, um die Freigabe von Inhalten zwischen mehreren Benutzern in Proxycaches zu vermeiden, wenn der Server unterschiedliche Verhaltensweisen für private Inhalte aufweist.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die Policy-Eigenschaft angezeigt. Der Standardwert ist 0 (DontCache).

Wert	Schlüsselwort	Beschreibung
0	`DontCache`	Die Antwort wird nicht im Ausgabecache platziert. Kernelzwischenspeicherung kann jedoch weiterhin auftreten.
1	`CacheUntilChange`	Die Antwort wird zwischengespeichert, bis der Eintrag ungültig ist oder nach dem Zeitraum der in der `Duration`-Eigenschaft angegebenen Inaktivität abläuft.
2	`CacheForTimePeriod`	Die Antwort wird für die von der `Duration`-Eigenschaft angegebene Zeitspanne zwischengespeichert, auch wenn der Eintrag in der Zwischenzeit ungültig ist.
3	`DisableCache`	Der Cache ist deaktiviert, und es tritt keine Zwischenspeicherung auf.

Beispiel

Im folgenden Beispiel werden alle CachingProfileElement-Objekte für die Standardwebsite angezeigt.

' 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

Vererbungshierarchie

CollectionElement

CachingProfileElement

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
CachingProfileSettings-Klasse
CachingSection-Klasse
CollectionElement-Klasse
HttpClientCache-Klasse

Freigeben über