Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
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