HttpRequestCachePolicy Classe

Definição

Namespace:

System.Net.Cache

Assembly:

System.Net.Requests.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Define os requisitos de cache de um aplicativo para os recursos obtidos usando objetos HttpWebRequest.

public ref class HttpRequestCachePolicy : System::Net::Cache::RequestCachePolicy

public class HttpRequestCachePolicy : System.Net.Cache.RequestCachePolicy

type HttpRequestCachePolicy = class
    inherit RequestCachePolicy

Public Class HttpRequestCachePolicy
Inherits RequestCachePolicy

Herança

Object

RequestCachePolicy

HttpRequestCachePolicy

Exemplos

O exemplo de código a seguir cria uma política de cache padrão para o domínio do aplicativo e substitui-a por uma solicitação.

// The following method demonstrates overriding the
// caching policy for a request.
static WebResponse^ GetResponseNoCache( Uri^ uri )
{
   // Set a default policy level for the "http:" and "https" schemes.
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpRequestCacheLevel::Default );
   HttpWebRequest::DefaultCachePolicy = policy;

   // Create the request.
   WebRequest^ request = WebRequest::Create( uri );

   // Define a cache policy for this request only. 
   HttpRequestCachePolicy^ noCachePolicy = gcnew HttpRequestCachePolicy( HttpRequestCacheLevel::NoCacheNoStore );
   request->CachePolicy = noCachePolicy;
   WebResponse^ response = request->GetResponse();
   Console::WriteLine( L"IsFromCache? {0}", response->IsFromCache );
   
   return response;
}

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

Você pode especificar uma política de cache padrão para seu aplicativo usando a DefaultCachePolicy propriedade ou os arquivos de configuração do aplicativo ou do computador. Para obter mais informações, consulte <o elemento requestCaching> (Configurações de rede).

Você pode especificar a política de cache para uma solicitação individual usando a CachePolicy propriedade.

não há suporte para Caching para serviços Web.

Construtores

HttpRequestCachePolicy()	Inicializa uma nova instância da classe HttpRequestCachePolicy.
HttpRequestCachePolicy(DateTime)	Inicializa uma nova instância da classe HttpRequestCachePolicy usando a data de sincronização de cache especificada.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Inicializa uma nova instância da classe HttpRequestCachePolicy usando os valores temporais e de controle de idade especificados.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Inicializa uma nova instância da classe HttpRequestCachePolicy usando o valor temporal, o valor de controle de idade e o valor de idade máxima especificados.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Inicializa uma nova instância da classe HttpRequestCachePolicy usando o valor temporal, o valor de controle de idade, o valor de idade máxima e a data de sincronização de cache especificados.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Inicializa uma nova instância da classe HttpRequestCachePolicy usando a política de cache especificada.

Propriedades

CacheSyncDate	Obtém a data de sincronização do cache para esta instância.
Level	Obtém o valor de HttpRequestCacheLevel especificado quando essa instância foi criada.
MaxAge	Obtém a idade máxima permitida para um recurso retornado do cache.
MaxStale	Obtém o valor de desatualização máxima permitido para um recurso retornado do cache.
MinFresh	Obtém o valor de atualização mínima permitido para um recurso retornado do cache.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma representação de cadeia de caracteres dessa instância.

Confira também

• Gerenciamento de cache para aplicativos de rede