HttpRequestCacheLevel Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica o comportamento de cache para recursos obtidos usando o protocolo HTTP (Transferência de Hipertexto).
public enum class HttpRequestCacheLevelpublic enum HttpRequestCacheLeveltype HttpRequestCacheLevel = Public Enum HttpRequestCacheLevel- Herança
Campos
| Nome | Valor | Description |
|---|---|---|
| Default | 0 | Atende a uma solicitação de um recurso usando a cópia armazenada em cache do recurso ou enviando uma solicitação para o recurso para o servidor. A ação tomada é determinada pela política de cache atual e pela idade do conteúdo no cache. Esse é o nível de cache que deve ser usado pela maioria dos aplicativos. |
| BypassCache | 1 | Atende a uma solicitação usando o servidor. Nenhuma entrada é retirada de caches, adicionada a caches ou removida de caches entre o cliente e o servidor. Nenhuma entrada é retirada de caches, adicionada a caches ou removida de caches entre o cliente e o servidor. Esse é o comportamento de cache padrão especificado no arquivo de configuração do computador fornecido com o .NET Framework. |
| CacheOnly | 2 | Atende a uma solicitação usando o recurso armazenado em cache localmente; não envia uma solicitação para um item que não está no cache. Quando esse nível de política de cache é especificado, uma WebException exceção é gerada se o item não estiver no cache do cliente. |
| CacheIfAvailable | 3 | Atende a uma solicitação de um recurso do cache se o recurso estiver disponível; caso contrário, envia uma solicitação de um recurso para o servidor. Se o item solicitado estiver disponível em qualquer cache entre o cliente e o servidor, a solicitação poderá ser atendida pelo cache intermediário. |
| Revalidate | 4 | Compara a cópia do recurso no cache com a cópia no servidor. Se a cópia no servidor for mais recente, ela será usada para atender à solicitação e substituirá a cópia no cache. Se a cópia no cache for a mesma que a cópia do servidor, a cópia armazenada em cache será usada. No protocolo de cache HTTP, isso é obtido usando uma solicitação condicional. |
| Reload | 5 | Atende a uma solicitação usando o servidor. A resposta pode ser salva no cache. No protocolo de cache HTTP, isso é obtido usando a diretiva de controle de cache sem cache e o cabeçalho sem cache |
| NoCacheNoStore | 6 | Nunca atende a uma solicitação usando recursos do cache e não armazena recursos em cache. Se o recurso estiver presente no cache local, ele será removido. Esse nível de política indica aos caches intermediários que eles devem remover o recurso. No protocolo de cache HTTP, isso é obtido usando a diretiva de controle de cache sem cache. |
| CacheOrNextCacheOnly | 7 | Atende a uma solicitação de um recurso no cache do computador local ou em um cache remoto na rede local. Se a solicitação não puder ser atendida, uma WebException exceção será gerada. No protocolo de cache HTTP, isso é obtido usando a |
| Refresh | 8 | Atende a uma solicitação usando o servidor ou um cache diferente do cache local. Antes que a solicitação possa ser atendida por um cache intermediário, esse cache deve revalidar sua entrada armazenada em cache com o servidor. No protocolo de cache HTTP, isso é obtido usando a diretiva de controle de cache max-age = 0 e o cabeçalho sem cache |
Exemplos
O exemplo de código a seguir define a política de cache do domínio do aplicativo como Padrão.
// The following method demonstrates overriding the
// caching policy for a request.
public static WebResponse GetResponseNoCache(Uri uri)
{
// Set a default policy level for the "http:" and "https" schemes.
HttpRequestCachePolicy policy = new HttpRequestCachePolicy(HttpRequestCacheLevel.Default);
HttpWebRequest.DefaultCachePolicy = policy;
// Create the request.
WebRequest request = WebRequest.Create(uri);
// Define a cache policy for this request only.
HttpRequestCachePolicy noCachePolicy = new HttpRequestCachePolicy(HttpRequestCacheLevel.NoCacheNoStore);
request.CachePolicy = noCachePolicy;
WebResponse response = request.GetResponse();
Console.WriteLine("IsFromCache? {0}", response.IsFromCache);
return response;
}
Comentários
Essa enumeração é usada para definir o nível de cache especificado pelos HttpRequestCachePolicy objetos.
Esse BypassCache valor é o comportamento de cache padrão especificado no arquivo de configuração do computador fornecido com o .NET Framework. Nenhuma entrada é retirada de caches, adicionada a caches ou removida de caches entre o cliente e o servidor.
A HttpWebRequest.DefaultCachePolicy propriedade é usada para obter ou definir a política de cache padrão para HttpWebRequest instâncias. A WebRequest.DefaultCachePolicy propriedade é usada para obter ou definir a política de cache padrão para uma WebRequest instância. A CachePolicy propriedade é usada para obter ou definir a política de cache para uma solicitação específica.
Uma cópia de um recurso só será adicionada ao cache se o fluxo de resposta do recurso for recuperado e lido até o final do fluxo. Portanto, outra solicitação para o mesmo recurso pode usar uma cópia armazenada em cache, dependendo do nível de política de cache padrão dessa solicitação.
