Partilhar via


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

Controla o mecanismo de cache para pedidos de rede.

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

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 a cache proporciona isolamento entre a informação de diferentes utilizadores. O valor predefinido é true. Este valor deve ser false para aplicações de nível intermédio.
disableAllCaching Especifica que a cache está desativada para todas as respostas Web e não pode ser sobreposta programaticamente.
defaultPolicyLevel Um dos valores na RequestCacheLevel enumeração. O valor predefinido é BypassCache.
unspecifiedMaximumAge Especifica o tempo padrão após o qual o conteúdo é marcado como expirado.

Atributo policyLevel

Valor Description
Default Devolve o recurso em cache se este for novo, o comprimento do conteúdo for preciso e os atributos de expiração, modificação e duração 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 é descarregado do servidor e devolvido ao chamador.
Revalidate Devolve o recurso em cache se o carimbo temporal do recurso em cache for o mesmo que o carimbo temporal do recurso no servidor; caso contrário, o recurso é descarregado do servidor, armazenado na cache e devolvido ao chamador.
Reload Descarrega o recurso do servidor, armazena-o na cache e devolve o recurso ao chamador.
NoCacheNoStore Se existir um recurso em cache, é eliminado. O recurso é descarregado do servidor e devolvido ao chamador.
Revalidate Satisfaz um pedido usando a cópia em cache do recurso se o carimbo temporal for igual ao carimbo temporal do recurso no servidor; caso contrário, o recurso é descarregado do servidor, apresentado ao chamador e armazenado na cache,

Elementos Subordinados

Elemento Description
defaultHttpCachePolicy Elemento opcional.

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

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

Elementos Principais

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

Example

O exemplo seguinte mostra como desativar todo o caching.

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

Consulte também