WebRequest.CachePolicy Propriedade

Definição

Espaço de Nomes:
System.Net
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Recebe ou define a política de cache para este pedido.

public:
 virtual property System::Net::Cache::RequestCachePolicy ^ CachePolicy { System::Net::Cache::RequestCachePolicy ^ get(); void set(System::Net::Cache::RequestCachePolicy ^ value); };
public virtual System.Net.Cache.RequestCachePolicy CachePolicy { get; set; }
member this.CachePolicy : System.Net.Cache.RequestCachePolicy with get, set
Public Overridable Property CachePolicy As RequestCachePolicy

Valor de Propriedade

RequestCachePolicy

Um objeto que define uma política de RequestCachePolicy cache.

Exemplos

O exemplo de código seguinte demonstra como definir a política de cache para um pedido Web.

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

Observações

Atenção

WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.

A política atual da cache e a presença do recurso solicitado na cache determinam se uma resposta pode ser recuperada da cache. O uso de respostas em cache normalmente melhora o desempenho da aplicação, mas existe o risco de que a resposta na cache não corresponda à resposta do servidor.

A política de cache por defeito pode ser especificada no ficheiro de configuração Machine.config ou definindo a DefaultCachePolicy propriedade para pedidos que utilizam o esquema URI Hypertext Transfer Protocol (HTTP) ou Secure Hypertext Transfer Protocol (HTTPS).

Uma cópia de um recurso só é adicionada à cache se o fluxo de resposta do recurso for recuperado e lido até ao final do fluxo. Assim, outro pedido para o mesmo recurso pode usar uma cópia em cache, dependendo do nível da política de cache para este pedido.

Aplica-se a

Ver também