HttpClientCache-Klasse

Artikel
03/25/2024

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

Freigeben über