Compartilhar via

Classe HttpClientCache

  • Artigo

Expõe a configuração de cache para um cliente HTTP.

Sintaxe

class HttpClientCache : EmbeddedObject

Métodos

Essa classe não contém métodos.

Propriedades

A tabela a seguir lista as propriedades expostas pela classe HttpClientCache.

Nome Descrição
CacheControlCustom Um valor string de leitura/gravação que especifica um cabeçalho Cache-Control HTTP 1.1 a ser adicionado à resposta.
CacheControlMaxAge Um valor datetime de leitura/gravação que especifica tempo máximo decorrido para o controle de cache HTTP 1.1. O padrão é 1 dia.
CacheControlMode Uma enumeração sint32 de leitura/gravação que especifica o modo a ser usado para o cache do cliente. Os valores possíveis estão listados posteriormente na seção Comentários.
HttpExpires Um valor string de leitura/gravação que especifica, no formato de RFC (Solicitação de Comentários) 1123, a data e a hora após a qual uma resposta armazenada em cache será considerada obsoleta.

Subclasses

Essa classe não contém subclasses.

Comentários

As instâncias dessa classe estão contidas na propriedade da matriz ClientCache da classe StaticContentSection.

A tabela a seguir contém os possíveis valores da propriedade CacheControlMode. O padrão é 0 (NoControl).

Valor Palavra-chave Descrição
0 NoControl Não adiciona um cabeçalho Cache-Control ou Expires à resposta.
1 DisableCache Adiciona um cabeçalho Cache-Control: no-cache à resposta.
2 UseMaxAge Adiciona um cabeçalho Cache-Control: max-age=<nnn> à resposta com base no valor especificado na propriedade CacheControlMaxAge.
3 UseExpires Adiciona um cabeçalho Expires: <date> à resposta com base na data especificada na propriedade HttpExpires.

Para obter mais informações sobre campos de cabeçalho, confira RFC (Solicitação de Comentários) 2616, "Protocolo de Transferência de Hipertexto – HTTP/1.1".

Para obter mais informações sobre formatos de data e hora, confira RFC 1123, "Requisitos para Hosts da Internet – Aplicativo e Suporte".

Exemplo

O exemplo a seguir exibe as propriedades da 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

Hierarquia de herança

EmbeddedObject

HttpClientCache

Requisitos

Tipo Descrição
Cliente – IIS 7.0 no Windows Vista
– IIS 7.5 no Windows 7
– IIS 8.0 no Windows 8
– IIS 10.0 no Windows 10
Servidor – IIS 7.0 no Windows Server 2008
– IIS 7.5 no Windows Server 2008 R2
– IIS 8.0 no Windows Server 2012
– IIS 8.5 no Windows Server 2012 R2
– IIS 10.0 no Windows Server 2016
Product – IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Arquivo MOF WebAdministration.mof

Confira também

Classe EmbeddedObject
Classe StaticContentSection
CIM_DATETIME
Método Datetime.Parse