HttpCachePolicySettings Class

Representa a política de cache HTTP padrão para recursos de rede.

Sintaxe

class HttpCachePolicySettings : EmbeddedObject  

Métodos

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

Propriedades

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

Nome	Descrição
MaximumAge	Um valor de leitura/gravação datetime que especifica a idade máxima permitida para um recurso retornado do cache. O padrão é infinito. Se a cópia armazenada em cache do recurso for mais antiga do que o valor temporal especificado, o recurso deverá ser revalidado comparando o recurso armazenado em cache com o recurso no servidor.
MaximumStale	Um valor de leitura/gravação datetime que especifica a quantidade de tempo que a cópia armazenada em cache do recurso pode ser usada após a expiração do conteúdo. O padrão é 0.
MinimumFresh	Um valor de leitura/gravação datetime que especifica a quantidade de tempo que a cópia armazenada em cache do recurso pode ser usada antes da expiração do conteúdo. O padrão é 0.
PolicyLevel	Um valor de leitura/gravação sint32 que especifica o comportamento de cache HTTP para o computador local. Os valores possíveis estão listados posteriormente na seção Comentários.

Subclasses

Essa classe não contém subclasses.

Comentários

As instâncias dessa classe estão contidas na propriedade DefaultHttpCachePolicy da classe RequestCachingSection .

A tabela a seguir lista os possíveis valores da propriedade PolicyLevel. O padrão é 0 (Default).

Valor	Palavra-chave	Descrição
0	Default	Atende a uma solicitação para um recurso usando a cópia em cache do recurso ou enviando uma solicitação para o recurso ao servidor. A ação adotada é determinada pela política de cache em vigor e o tempo decorrido do conteúdo no cache. Esse é o nível de cache que a maioria dos aplicativos deve usar.
1	BypassCache	Atende a uma solicitação usando o servidor. Nenhuma entrada é retirada, adicionada ou removida dos caches entre o cliente e o servidor. Esse é o comportamento de cache padrão especificado no arquivo de configuração do computador incluído com o .NET Framework.
2	CacheOnly	Atende a uma solicitação usando o recurso armazenado localmente em cache; não envia uma solicitação para um item que não está no cache. Ao se especificar esse nível de política de cache, uma exceção WebException será lançada se o item não estiver no cache do cliente.
3	CacheIfAvailable	Atenderá a uma solicitação para um recurso do cache se o recurso estiver disponível no cache, caso contrário, enviará uma solicitação para um recurso ao servidor. Se o item solicitado não estiver disponível no cache local, mas estiver disponível em um cache entre o cliente e o servidor, o cache intermediário atenderá à solicitação.
4	Revalidate	Atende a uma solicitação usando a cópia do recurso armazenada em cache se o carimbo de data/hora for igual ao do recurso no servidor; caso contrário, o recurso será baixado do servidor, apresentado ao chamador e armazenado no cache.
5	Reload	Atende a uma solicitação usando o servidor. A resposta pode ser salva no cache, dependendo das configurações da diretiva de controle de cache no-cache e do cabeçalho Pragma: no-cache no protocolo de cache HTTP.
6	NoCacheNoStore	Nunca atende a uma solicitação usando os recursos do cache e não armazena os recursos em cache. Se o recurso estiver presente no cache local, ele será removido. Esse nível de política indica aos caches intermediários que eles devem remover o recurso. No protocolo de cache HTTP, isso é feito usando a diretiva de controle de cache no-cache.
7	CacheOrNextCacheOnly	Atende a uma solicitação para um recurso do cache do computador local ou um cache remoto para a rede local. Se a solicitação não puder ser atendida, uma exceção WebException será lançada. No protocolo de cache HTTP, isso é feito usando a diretiva de controle de cache only-if-cached.
8	Refresh	Atende uma solicitação usando o servidor ou um cache diferente do cache local. Antes que um cache intermediário possa atender à solicitação, esse cache deve revalidar sua entrada armazenada em cache com o servidor. No protocolo de cache HTTP, isso é feito usando a diretiva de controle de cache max-age = 0 e o cabeçalho Pragma:``no-cache.

Exemplo

O exemplo de código a seguir especifica a diretiva de cache http e define valores para as propriedades MinimumFresh, MaximumStale e MaximumAge.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the RequestCachingSection.  
Set oSection = oWebAdmin.Get("RequestCachingSection.Path=" & _  
    "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Display the class name of the section.  
WScript.Echo "[ " & oSection.Path_.Class & " ]"  
  
' Display the initial values for the DefaultHttpCachePolicy property.  
Call DisplayValues("Initial Values", oSection.DefaultHttpCachePolicy)  
  
' Set the http cache policy to use the default.  
oSection.DefaultHttpCachePolicy.PolicyLevel = 0  
  
' Set the MinimumFresh property to 30 minutes.  
oSection.DefaultHttpCachePolicy.MinimumFresh = "00000000003000.000000:000"  
  
' Set the MaximumStale property to 10 minutes.  
oSection.DefaultHttpCachePolicy.MaximumStale = "00000000001000.000000:000"  
  
' Set the MaximumAge property to 1 hour.  
oSection.DefaultHttpCachePolicy.MaximumAge =   "00000000010000.000000:000"  
  
' Save the values to configuration.  
oSection.Put_  
  
' Refresh the oSection object variable with the new values.  
oSection.Refresh_  
  
' Show the changed values.  
Call DisplayValues("New Values", oSection.DefaultHttpCachePolicy)  
  
' ==== DisplayValues helper function. ====  
Function DisplayValues(HeadingText, oObject)  
    WScript.Echo  
    WScript.Echo String(Len(HeadingText), "=")  
    WScript.Echo HeadingText  
    WScript.Echo String(Len(HeadingText), "=")  
  
    For Each Prop In oObject.Properties_  
        WScript.Echo Prop.Name & ": " & Prop.Value  
    Next  
End Function  
  

Hierarquia de herança

EmbeddedObject

HttpCachePolicySettings

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

EmbeddedObject Class
Classe FtpCachePolicySettings
Classe RequestCachingSection
CIM_DATETIME