Compartilhar via


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

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

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

Sintaxe

<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.

Attributes

Attribute Description
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 RequestCacheLevel enumeração. O valor padrão é BypassCache.
unspecifiedMaximumAge Especifica o tempo padrão após o qual o conteúdo está marcado como expirado.

Atributo policyLevel

Value Description
Default Retorna o recurso armazenado em cache se o recurso for novo, o comprimento do conteúdo for preciso e os atributos de expiração, modificação e comprimento de 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 do recurso armazenado em cache for o mesmo que o carimbo de data/hora do recurso no servidor; caso contrário, o recurso é baixado do servidor, armazenado no cache e é retornado ao chamador.
Reload Baixa o recurso do servidor, armazena-o no cache e retorna o recurso para o chamador.
NoCacheNoStore Se houver um recurso armazenado em cache, ele será excluído. O recurso é baixado do servidor e retornado ao chamador.
Revalidate Atende a uma solicitação usando a cópia armazenada em cache do recurso se o carimbo de data/hora for o mesmo que o carimbo de data/hora do recurso no servidor; caso contrário, o recurso é baixado do servidor, apresentado ao chamador e armazenado no cache,

Elementos filho

Elemento Description
defaultHttpCachePolicy Elemento opcional.

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

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

Elementos pai

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

Example

O exemplo a seguir mostra como desabilitar todo o cache.

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

Consulte também