HttpCachePolicy.SetCacheability Método

Definición

Establece el encabezado HTTP Cache-Control.Sets the Cache-Control HTTP header. El encabezado HTTP Cache-Controlcontrola la forma en que los documentos se almacenan en la memoria caché de la red.The Cache-Control HTTP header controls how documents are to be cached on the network.

Sobrecargas

SetCacheability(HttpCacheability)

Establece el encabezado Cache-Controlen uno de los valores de HttpCacheability.Sets the Cache-Control header to one of the values of HttpCacheability.

SetCacheability(HttpCacheability, String)

Establece el encabezado Cache-Controlen uno de los valores de HttpCacheability y agrega una extensión a la directiva.Sets the Cache-Control header to one of the values of HttpCacheability and appends an extension to the directive.

SetCacheability(HttpCacheability)

Establece el encabezado Cache-Controlen uno de los valores de HttpCacheability.Sets the Cache-Control header to one of the values of 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

Valor de enumeración HttpCacheability.An HttpCacheability enumeration value.

Excepciones

cacheability no es ninguno de los valores de enumeración.cacheability is not one of the enumeration values.

Ejemplos

En el ejemplo de código siguiente se muestra cómo Cache-Control establecer el encabezado en el valor enumerado de. no-cacheThe following code example demonstrates how to set the Cache-Control header to the enumerated value for no-cache.

Response.Cache.SetCacheability(HttpCacheability.NoCache);
 
Response.Cache.SetCacheability(HttpCacheability.NoCache)
 

Comentarios

SetCacheabilityse incluye en la versión .NET Framework 3,5.SetCacheability is introduced in the .NET Framework version 3.5. Para más información, vea Versiones y dependencias.For more information, see Versions and Dependencies.

SetCacheability(HttpCacheability, String)

Establece el encabezado Cache-Controlen uno de los valores de HttpCacheability y agrega una extensión a la directiva.Sets the Cache-Control header to one of the values of HttpCacheability and appends an extension to the directive.

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

Valor de enumeración HttpCacheability que se va a asignar al encabezado.The HttpCacheability enumeration value to set the header to.

field
String

Extensión de control de caché que se va a agregar al encabezado.The cache control extension to add to the header.

Excepciones

field es null.field is null.

cacheability no es Private ni NoCache.cacheability is not Private or NoCache.

Ejemplos

En el ejemplo de código siguiente se Cache-Control muestra cómo el encabezado se establece en private el valor de enumeración y se agrega una extensión cache-control.The following code example demonstrates how the Cache-Control header is set to the enumeration value private and adds a cache-control extension. La Directiva Modified significa que, además de cualquier caché no compartida, cualquier caché compartida solo por los miembros de la comunidad denominada "DEV" puede almacenar en caché la respuesta.The modified directive means that in addition to any non-shared cache, any cache shared only by members of the community named "DEV" may cache the response.

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

Comentarios

La extensión de nombre de campo solo es válida cuando se private usa no-cache con las directivas o.The field name extension is valid only when used with the private or no-cache directives. Para obtener más información, consulte RFC 2616: Protocolo de transferencia de hipertexto (HTTP/1.1), disponible en el sitio web de World Wide Web Consortium (W3C).For more information, see RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1, available on the World Wide Web Consortium (W3C) Web site.

Este método producirá una excepción de argumento no válido si se combinan directivas y extensiones no compatibles.This method will throw an invalid argument exception if incompatible directives and extensions are combined.

SetCacheabilityse incluye en la versión .NET Framework 3,5.SetCacheability is introduced in the .NET Framework version 3.5. Para más información, vea Versiones y dependencias.For more information, see Versions and Dependencies.

Se aplica a