HttpClientCache (clase)

Expone la configuración de almacenamiento en caché de un cliente HTTP.

Sintaxis

class HttpClientCache : EmbeddedObject  

Métodos

Esta clase no contiene métodos.

Propiedades

La siguiente tabla muestra las propiedades que expone la clase HttpClientCache.

Nombre	Descripción
CacheControlCustom	Valor string de lectura y escritura que especifica un encabezado HTTP 1.1 Cache-Control que se va a agregar a la respuesta.
CacheControlMaxAge	Valor datetime de lectura y escritura que especifica la antigüedad máxima del control de caché HTTP 1.1. El valor predeterminado es 1 día.
CacheControlMode	Enumeración sint32 de lectura y escritura que especifica el modo que se va a usar para el almacenamiento en caché del cliente. Los valores posibles se enumeran más adelante en la sección Comentarios.
HttpExpires	Valor string de lectura y escritura que especifica, en formato Request for Comments (RFC) 1123, la fecha y hora después de la cual una respuesta almacenada en caché se considera obsoleta.

Subclases

Esta clase no contiene subclases.

Comentarios

Las instancias de esta clase están contenidas en la propiedad de matriz ClientCache de la clase StaticContentSection.

La tabla siguiente contiene los posibles valores de la propiedad CacheControlMode. El valor predeterminado es 0 (NoControl).

Valor	Palabra clave	Descripción
0	NoControl	No agrega un encabezado Cache-Control o Expires a la respuesta.
1	DisableCache	Agrega un encabezado Cache-Control: no-cache a la respuesta.
2	UseMaxAge	Agrega un encabezado Cache-Control: max-age=<nnn> a la respuesta según el valor especificado en la propiedad CacheControlMaxAge.
3	UseExpires	Agrega un encabezado Expires: <date> a la respuesta según la fecha especificada en la propiedad HttpExpires.

Para obtener más información sobre los campos de encabezado, vea Solicitud de comentarios (RFC) 2616, "Protocolo de transferencia de hipertexto: HTTP/1.1".

Para obtener más información sobre los formatos de fecha y hora, vea RFC 1123, "Requisitos para los hosts de Internet: aplicación y soporte técnico".

Ejemplo

En el ejemplo siguiente se muestran las propiedades de la clase 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  

Jerarquía de herencia

EmbeddedObject

HttpClientCache

Requisitos

Tipo	Descripción
Remoto	- IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10
Server	- IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016
Producto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Archivo MOF	WebAdministration.mof

Consulte también

EmbeddedObject (clase)
StaticContentSection (clase)
CIM_DATETIME
Datetime.Parse (método)