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

Artigo
05/10/2023

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>

Partilhar via