HttpCachePolicy.SetCacheability Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Define o cabeçalho HTTP Cache-Control. O cabeçalho HTTP Cache-Control controla como os documentos deverão ser armazenados em cache na rede.

Sobrecargas

SetCacheability(HttpCacheability)	Define o cabeçalho Cache-Control para um dos valores de HttpCacheability.
SetCacheability(HttpCacheability, String)	Define o cabeçalho Cache-Control como um dos valores de HttpCacheability e acrescenta uma extensão à diretiva.

SetCacheability(HttpCacheability)

Define o cabeçalho Cache-Control para um dos valores de HttpCacheability.

public:
 void SetCacheability(System::Web::HttpCacheability cacheability);

public void SetCacheability (System.Web.HttpCacheability cacheability);

member this.SetCacheability : System.Web.HttpCacheability -> unit

Public Sub SetCacheability (cacheability As HttpCacheability)

Parâmetros

cacheability

HttpCacheability

Um valor de enumeração HttpCacheability.

Exceções

ArgumentOutOfRangeException

cacheability não é um dos valores de enumeração.

Exemplos

O exemplo de código a seguir demonstra como definir o Cache-Control cabeçalho para o valor enumerado para no-cache.

Response.Cache.SetCacheability(HttpCacheability.NoCache);

Response.Cache.SetCacheability(HttpCacheability.NoCache)

Comentários

SetCacheabilityé introduzido no .NET Framework versão 3.5. Para saber mais, confira Versões e dependências.

SetCacheability(HttpCacheability, String)

Define o cabeçalho Cache-Control como um dos valores de HttpCacheability e acrescenta uma extensão à diretiva.

public:
 void SetCacheability(System::Web::HttpCacheability cacheability, System::String ^ field);

public void SetCacheability (System.Web.HttpCacheability cacheability, string field);

member this.SetCacheability : System.Web.HttpCacheability * string -> unit

Public Sub SetCacheability (cacheability As HttpCacheability, field As String)

Parâmetros

cacheability

HttpCacheability

O valor da enumeração HttpCacheability para o qual o cabeçalho será definido.

field

String

A extensão de controle de cache para adicionar ao cabeçalho.

Exceções

ArgumentNullException

field é null.

ArgumentException

cacheability não é Private ou NoCache.

Exemplos

O exemplo de código a seguir demonstra como o Cache-Control cabeçalho é definido como o valor private de enumeração e adiciona uma extensão de controle de cache. A diretiva modificada significa que, além de qualquer cache não compartilhado, qualquer cache compartilhado somente por membros da comunidade denominado "DEV" pode armazenar a resposta em cache.

Response.Cache.SetCacheability(HttpCacheability.Private, "Community=DEV");

Response.Cache.SetCacheability(HttpCacheability.Private, "Community=DEV")

Comentários

A extensão de nome de campo é válida somente quando usada com as diretivas ou no-cache as private diretivas. Para obter mais informações, consulte RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1, disponível no site do W3C (World Wide Web Consortium).

Esse método gerará uma exceção de argumento inválida se as diretivas e extensões incompatíveis forem combinadas.

SetCacheabilityé introduzido no .NET Framework versão 3.5. Para saber mais, confira Versões e dependências.