Classe HttpClientCache

Article
03/24/2024

Expose la configuration de mise en cache d’un client HTTP.

Syntaxe

class HttpClientCache : EmbeddedObject

Méthodes

Cette classe ne contient pas de méthodes.

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe HttpClientCache.

Nom	Description
`CacheControlCustom`	Valeur `string` de lecture/écriture qui spécifie un en-tête `Cache-Control` HTTP 1.1 à ajouter à la réponse.
`CacheControlMaxAge`	Valeur `datetime` de lecture/écriture qui spécifie l’âge maximal du contrôle de cache HTTP 1.1. La valeur par défaut est 1 jour.
`CacheControlMode`	Énumération `sint32` en lecture/écriture qui spécifie la mode à utiliser pour la mise en cache du client. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
`HttpExpires`	Valeur `string` en lecture/écriture qui spécifie, au format Requête pour les commentaires (RFC) 1123, la date et l’heure après lesquelles une réponse mise en cache est considérée comme obsolète.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Les instances de cette classe sont contenues dans la propriété de tableau ClientCache de la classe StaticContentSection.

Le tableau suivant contient les valeurs possibles pour la propriété CacheControlMode. La valeur par défaut est 0 (NoControl).

Valeur	Mot clé	Description
0	`NoControl`	N’ajoute pas d’en-tête `Cache-Control` ou `Expires` à la réponse.
1	`DisableCache`	Ajoute un en-tête `Cache-Control: no-cache` à la réponse.
2	`UseMaxAge`	Ajoute un en-tête `Cache-Control: max-age=<nnn>` à la réponse en fonction de la valeur spécifiée dans la propriété `CacheControlMaxAge`.
3	`UseExpires`	Ajoute un en-tête `Expires: <date>` à la réponse en fonction de la date spécifiée dans la propriété `HttpExpires`.

Pour plus d’informations à propos des champs d’en-tête, consultez le document Requête pour les commentaires (RFC) 2616, « protocole HTTP : HTTP/1.1 ».

Pour plus d’informations à propos des formats de date et d’heure, consultez RFC 1123, « Configuration requise pour les hôtes Internet : application et support ».

Exemple

L’exemple suivant affiche les propriétés pour la classe HttpClientCache.

' 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

Hiérarchie d'héritage

EmbeddedObject

HttpClientCache

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sur Windows 10
Serveur	- IIS 7.0 sous Windows Server 2008 - IIS 7.5 sous Windows Server 2008 R2 - IIS 8.0 sous Windows Server 2012 - IIS 8.5 sous Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016
Produit	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF	WebAdministration.mof

Voir aussi

Classe EmbeddedObject
Classe StaticContentSection
CIM_DATETIME
Méthode Datetime.Parse

Partager via