HttpClientCache-Klasse

Macht die Zwischenspeicherungskonfiguration für einen HTTP-Client verfügbar.

Syntax

class HttpClientCache : EmbeddedObject  

Methoden

Diese Klasse enthält keine Methoden.

Eigenschaften

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

Name	Beschreibung
CacheControlCustom	Ein Lese-/Schreibwert string, der einen HTTP 1.1-Header Cache-Control angibt, der der Antwort hinzugefügt werden soll.
CacheControlMaxAge	Ein Lese-/Schreibwert datetime, der das maximale Alter für das HTTP 1.1-Cachesteuerelement angibt. Der Standardwert ist 1 Tag.
CacheControlMode	Eine Lese-/Schreibaufzählung sint32, die den Modus angibt, der für die Clientzwischenspeicherung verwendet werden soll. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
HttpExpires	Ein Lese-/Schreibwert string, der im RFC-Format (Request for Comments) 1123 das Datum und die Uhrzeit angibt, nach der eine zwischengespeicherte Antwort als veraltet betrachtet wird.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Instanzen dieser Klasse sind in der ClientCache-Arrayeigenschaft der StaticContentSection-Klasse enthalten.

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

Wert	Schlüsselwort	Beschreibung
0	NoControl	Fügt der Antwort keinen Cache-Control- oder Expires-Header hinzu.
1	DisableCache	Fügt der Antwort einen Cache-Control: no-cache-Header hinzu.
2	UseMaxAge	Fügt der Antwort basierend auf dem in der CacheControlMaxAge-Eigenschaft angegebenen Wert einen Cache-Control: max-age=<nnn>-Header hinzu.
3	UseExpires	Fügt der Antwort basierend auf dem in der HttpExpires-Eigenschaft angegebenen Datum einen Expires: <date>-Header hinzu.

Weitere Informationen zu Headerfeldern finden Sie unter Request for Comments (RFC) 2616, „Hypertext Transfer Protocol -- HTTP/1.1.“

Weitere Informationen zu Datums- und Uhrzeitformaten finden Sie unter RFC 1123, „Requirements for Internet Hosts -- Application and Support“ (Anforderungen für Internethosts – Anwendung und Support)

Beispiel

Im folgenden Beispiel werden die Eigenschaften für die HttpClientCache-Klasse angezeigt.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Retrieve the static content section.  
Set oSection = oWebAdmin.Get("StaticContentSection.Path=" & _  
    "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Show the path and location.  
WScript.Echo "Path: " & oSection.Path  
WScript.Echo "Location: " & oSection.Location  
WScript.Echo  
  
Display the embedded HttpClientCache properties.  
Set ohttpClientCache = oSection.ClientCache  
WScript.Echo "HttpClientCache properties"  
WScript.Echo "--------------------------"  
WScript.Echo "CacheControlCustom: " & ohttpClientCache.CacheControlCustom  
WScript.Echo "CacheControlMaxAge: " & ohttpClientCache.CacheControlMaxAge  
WScript.Echo "CacheControlMode: " & _  
    GetCacheControlModeText(ohttpClientCache.CacheControlMode)  
WScript.Echo "HttpExpires: " & ohttpClientCache.HttpExpires  
  
' Provide text for CacheControlMode enumeration values.  
Function GetCacheControlModeText(uint32Mode)  
    Select Case uint32Mode  
        Case 0  
            GetCacheControlModeText="NoControl"  
        Case 1  
            GetCacheControlModeText="DisableCache"  
        Case 2  
            GetCacheControlModeText="UseMaxAge"  
        Case 3  
            GetCacheControlModeText="UseExpires"  
        Case Else  
            GetCacheControlModeText="Unknown Mode"  
    End Select  
End Function  

Vererbungshierarchie

EmbeddedObject

HttpClientCache

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
StaticContentSection-Klasse
CIM_DATETIME
Datetime.Parse-Methode