Compartilhar via

Elemento <requestCaching> (Configurações de Rede)

  • Artigo

Controla o mecanismo de cache para solicitações de rede.

<configuração>
  <system.net>
    <requestCaching>

Syntax

<requestCaching  
  isPrivateCache ="true|false"  
  disableAllCaching="true|false"  
  defaultPolicyLevel="BypassCache|Default|CacheOnly|CacheIfAvailable|Revalidate|Reload|NoCacheNoStore|Revalidate"  
  unspecifiedMaximumAge= "d.hh:mm:ss">  
    <defaultHttpCachePolicy>...</defaultHttpCachePolicy>  
    <defaultFtpCachePolicy>...</defaultFtpCachePolicy>  
</requestCaching>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo Descrição
isPrivateCache Especifica se o cache fornece isolamento entre as informações de usuários diferentes. O valor padrão é true. Esse valor deve ser false para aplicativos de camada intermediária.
disableAllCaching Especifica que o cache está desabilitado para todas as respostas da Web e não pode ser substituído programaticamente.
defaultPolicyLevel Um dos valores na enumeração RequestCacheLevel. O valor padrão é BypassCache.
unspecifiedMaximumAge Especifica o tempo padrão após o qual o conteúdo é marcado como expirado.

Atributo policyLevel

Valor Descrição
Default Retorna o recurso armazenado em cache se o recurso for novo, o comprimento do conteúdo for exato e os atributos de expiração, modificação e comprimento do conteúdo estiverem presentes.
BypassCache Retorna o recurso do servidor.
CacheOnly Retorna o recurso armazenado em cache se o comprimento do conteúdo estiver presente e corresponder ao tamanho da entrada.
CacheIfAvailable Retorna o recurso armazenado em cache se o comprimento do conteúdo for fornecido e corresponder ao tamanho da entrada; caso contrário, o recurso é baixado do servidor e retornado para o chamador.
Revalidate Retorna o recurso armazenado em cache se o carimbo de data/hora desse recurso for igual ao do recurso existente no servidor; caso contrário, o recurso será baixado do servidor, armazenado no cache e retornado para o chamador.
Reload Baixa o recurso do servidor, armazena-o no cache e retorna-o para o chamador.
NoCacheNoStore Se existir um recurso armazenado em cache, ele será excluído. O recurso é baixado do servidor e retornado para o chamador.
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.

Elementos filho

Elemento Descrição
defaultHttpCachePolicy Elemento opcional.

Descreve se o cache HTTP está ativo e também a política de cache padrão.
Elemento <defaultFtpCachePolicy> (Configurações de Rede) Elemento opcional.

Descreve se o cache de FTP está ativo e também a política de cache padrão.

Elementos pai

Elemento Descrição
system.net Contém configurações que especificam como o .NET Framework se conecta à rede.

Exemplo

O exemplo a seguir mostra como desabilitar todo o cache.

<configuration>  
  <system.net>  
    <requestCaching  
      disableAllCaching="true"  
    />  
  </system.net>  
</configuration>

Confira também