<requestCaching> Element (Definições de Rede)

  • Artigo

Controla o mecanismo de colocação em cache para pedidos 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 secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo Descrição
isPrivateCache Especifica se a cache fornece isolamento entre as informações de diferentes utilizadores. O valor predefinido é true. Este valor deve ser false para aplicações de camada média.
disableAllCaching Especifica que a colocação em cache está desativada para todas as respostas Web e não pode ser substituída programaticamente.
defaultPolicyLevel Um dos valores na RequestCacheLevel enumeração. O valor predefinido é BypassCache.
unspecifiedMaximumAge Especifica a hora predefinida após a qual o conteúdo é marcado como expirado.

atributo policyLevel

Valor Descrição
Default Devolve o recurso em cache se o recurso estiver fresco, o comprimento do conteúdo for exato e os atributos de expiração, modificação e comprimento do conteúdo estiverem presentes.
BypassCache Devolve o recurso do servidor.
CacheOnly Devolve o recurso em cache se o comprimento do conteúdo estiver presente e corresponder ao tamanho da entrada.
CacheIfAvailable Devolve o recurso em cache se o comprimento do conteúdo for fornecido e corresponder ao tamanho da entrada; caso contrário, o recurso é transferido a partir do servidor e é devolvido ao autor da chamada.
Revalidate Devolve o recurso em cache se o carimbo de data/hora do recurso em cache for o mesmo que o carimbo de data/hora do recurso no servidor; caso contrário, o recurso é transferido a partir do servidor, armazenado na cache e devolvido ao autor da chamada.
Reload Transfere o recurso do servidor, armazena-o na cache e devolve o recurso ao autor da chamada.
NoCacheNoStore Se existir um recurso em cache, este será eliminado. O recurso é transferido do servidor e é devolvido ao autor da chamada.
Revalidate Satisfaz um pedido ao utilizar a cópia 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 é transferido a partir do servidor, apresentado ao autor da chamada e armazenado na cache,

Elementos Subordinados

Elemento Descrição
defaultHttpCachePolicy Elemento opcional.

Descreve se a colocação em cache HTTP está ativa e descreve a política de colocação em cache predefinida.
<defaultFtpCachePolicy> Element (Definições de Rede) Elemento opcional.

Descreve se a colocação em cache de FTP está ativa e descreve a política de colocação em cache predefinida.

Elementos Principais

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

Exemplo

O exemplo seguinte mostra como desativar toda a colocação em cache.

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

Ver também