HttpCachePolicySettings-Klasse

Artikel
03/25/2024

Stellt die standardmäßige HTTP-Cacherichtlinie für Netzwerkressourcen dar.

Syntax

class HttpCachePolicySettings : EmbeddedObject

Methoden

Diese Klasse enthält keine Methoden.

Eigenschaften

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

Name	Beschreibung
`MaximumAge`	Ein Lese-/Schreibwert `datetime`, der das maximal zulässige Alter für eine Ressource angibt, die aus dem Cache zurückgegeben wird. Der Standardwert ist unendlich. Wenn die zwischengespeicherte Kopie der Ressource älter als der angegebene Zeitwert ist, muss die Ressource erneut überprüft werden, indem die zwischengespeicherte Ressource mit der Ressource auf dem Server verglichen wird.
`MaximumStale`	Ein Lese-/Schreibwert `datetime`, der den Zeitraum angibt, in dem die zwischengespeicherte Kopie der Ressource nach dem Inhaltsablauf verwendet werden kann. Der Standardwert ist 0.
`MinimumFresh`	Ein Lese-/Schreibwert `datetime`, der die Zeitspanne angibt, in der die zwischengespeicherte Kopie der Ressource vor dem Inhaltsablauf verwendet werden kann. Der Standardwert ist 0.
`PolicyLevel`	Ein Lese-/Schreibwert `sint32`, der das HTTP-Zwischenspeicherungsverhalten für den lokalen Computer angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Instanzen dieser Klasse sind in der DefaultHttpCachePolicy Eigenschaft der RequestCachingSection-Klasse enthalten.

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

Wert	Schlüsselwort	Beschreibung
0	`Default`	Erfüllt eine Anforderung für eine Ressource entweder mithilfe der zwischengespeicherten Kopie der Ressource oder durch Senden einer Anforderung für die Ressource an den Server. Die ausgeführte Aktion wird durch die aktuelle Cacherichtlinie und das Alter des Inhalts im Cache bestimmt. Dies ist die Cacheebene, die die meisten Anwendungen verwenden sollten.
1	`BypassCache`	Erfüllt eine Anforderung mithilfe des Servers. Es werden keine Einträge aus Caches übernommen, zu Caches hinzugefügt oder aus Caches zwischen Client und Server entfernt. Dies ist das Standardcacheverhalten, das in der Computerkonfigurationsdatei angegeben ist, die im .NET Framework enthalten ist.
2	`CacheOnly`	Erfüllt eine Anforderung mithilfe der lokal zwischengespeicherten Ressource; sendet keine Anforderung für ein Element, das sich nicht im Cache befindet. Wenn diese Cache-Richtlinienebene angegeben ist, wird eine WebException-Ausnahme ausgelöst, wenn sich das Element nicht im Client-Cache befindet.
3	`CacheIfAvailable`	Erfüllt eine Anforderung für eine Ressource aus dem Cache, wenn die Ressource im Cache verfügbar ist; sendet andernfalls eine Anforderung für eine Ressource an den Server. Wenn das angeforderte Element nicht im lokalen Cache verfügbar ist, aber in einem Cache zwischen dem Client und dem Server verfügbar ist, erfüllt der Zwischencache die Anforderung.
4	`Revalidate`	Erfüllt eine Anforderung durch Verwendung der zwischengespeicherten Kopie der Ressource, wenn der Zeitstempel mit dem Zeitstempel der Ressource auf dem Server übereinstimmt. andernfalls wird die Ressource vom Server heruntergeladen, dem Aufrufer präsentiert und im Cache gespeichert.
5	`Reload`	Erfüllt eine Anforderung mithilfe des Servers. Die Antwort kann im Cache gespeichert werden, abhängig von den Einstellungen der `no-cache` Cachesteuerelementdirektive und des `Pragma: no-cache` Headers im HTTP-Cacheprotokoll.
6	`NoCacheNoStore`	Erfüllt niemals eine Anforderung mithilfe von Ressourcen aus dem Cache und speichert keine Ressourcen. Wenn die Ressource im lokalen Cache vorhanden ist, wird sie entfernt. Diese Richtlinienebene weist Zwischencaches darauf hin, dass sie die Ressource entfernen sollen. Im HTTP-Caching-Protokoll wird dies durch die Verwendung der `no-cache` Cache-Control-Direktive erreicht.
7	`CacheOrNextCacheOnly`	Erfüllt eine Anforderung für eine Ressource aus dem Cache des lokalen Computers oder einem Remotecache im lokalen Netzwerk. Wenn die Anforderung nicht erfüllt werden kann, wird eine `WebException` Ausnahme ausgelöst. Im HTTP-Caching-Protokoll wird dies durch die Verwendung der `only-if-cached` Cache-Control-Direktive erreicht.
8	`Refresh`	Erfüllt eine Anforderung mithilfe des Servers oder eines anderen Caches als dem lokalen Cache. Bevor ein Zwischencache die Anforderung erfüllen kann, muss dieser Cache seinen zwischengespeicherten Eintrag mit dem Server erneut aktualisieren. Im HTTP-Cacheprotokoll wird dies mithilfe der `max-age = 0` Cachesteuerungsdirektive und des Pragma:``no-cache Headers erreicht.

Beispiel

Das folgende Codebeispiel gibt die HTTP-Zwischenspeicherungsrichtlinie an und legt Werte für die MinimumFresh, MaximumStale und MaximumAge Eigenschaften fest.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the RequestCachingSection.  
Set oSection = oWebAdmin.Get("RequestCachingSection.Path=" & _  
    "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Display the class name of the section.  
WScript.Echo "[ " & oSection.Path_.Class & " ]"  
  
' Display the initial values for the DefaultHttpCachePolicy property.  
Call DisplayValues("Initial Values", oSection.DefaultHttpCachePolicy)  
  
' Set the http cache policy to use the default.  
oSection.DefaultHttpCachePolicy.PolicyLevel = 0  
  
' Set the MinimumFresh property to 30 minutes.  
oSection.DefaultHttpCachePolicy.MinimumFresh = "00000000003000.000000:000"  
  
' Set the MaximumStale property to 10 minutes.  
oSection.DefaultHttpCachePolicy.MaximumStale = "00000000001000.000000:000"  
  
' Set the MaximumAge property to 1 hour.  
oSection.DefaultHttpCachePolicy.MaximumAge =   "00000000010000.000000:000"  
  
' Save the values to configuration.  
oSection.Put_  
  
' Refresh the oSection object variable with the new values.  
oSection.Refresh_  
  
' Show the changed values.  
Call DisplayValues("New Values", oSection.DefaultHttpCachePolicy)  
  
' ==== DisplayValues helper function. ====  
Function DisplayValues(HeadingText, oObject)  
    WScript.Echo  
    WScript.Echo String(Len(HeadingText), "=")  
    WScript.Echo HeadingText  
    WScript.Echo String(Len(HeadingText), "=")  
  
    For Each Prop In oObject.Properties_  
        WScript.Echo Prop.Name & ": " & Prop.Value  
    Next  
End Function

Vererbungshierarchie

EmbeddedObject

HttpCachePolicySettings

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

EmbeddedObject-Klasse
FtpCachePolicySettings-Klasse
RequestCachingSection-Klasse
CIM_DATETIME

Freigeben über