HttpCachePolicy.SetCacheability Méthode

  • Référence

Définition

Espace de noms:
System.Web
Assembly:
System.Web.dll

Définit l’en-tête HTTP Cache-Control. L'en-tête HTTP Cache-Control contrôle le mode de mise en cache des documents sur le réseau.

Surcharges

SetCacheability(HttpCacheability)

Affecte à l'en-tête Cache-Control l'une des valeurs de HttpCacheability.
SetCacheability(HttpCacheability, String)

Affecte à l'en-tête Cache-Control l'une des valeurs de HttpCacheability et ajoute une extension à la directive.

SetCacheability(HttpCacheability)

Affecte à l'en-tête Cache-Control l'une des valeurs 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)

Paramètres

cacheability
HttpCacheability

Valeur d'énumération de HttpCacheability.

Exceptions

ArgumentOutOfRangeException

cacheability n’est pas l’une des valeurs de l’énumération.

Exemples

L’exemple de code suivant montre comment définir l’en-tête Cache-Control sur la valeur énumérée pour no-cache.

Response.Cache.SetCacheability(HttpCacheability.NoCache);

Response.Cache.SetCacheability(HttpCacheability.NoCache)

Remarques

SetCacheability est introduit dans le .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances.

S’applique à

SetCacheability(HttpCacheability, String)

Affecte à l'en-tête Cache-Control l'une des valeurs de HttpCacheability et ajoute une extension à la 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)

Paramètres

cacheability
HttpCacheability

Valeur de l’énumération HttpCacheability à affecter à l’en-tête.

field
String

Extension de contrôle du cache à ajouter à l'en-tête.

Exceptions

ArgumentNullException

field a la valeur null.

ArgumentException

cacheability n'est pas Private, ni NoCache.

Exemples

L’exemple de code suivant montre comment l’en-tête Cache-Control est défini sur la valeur private d’énumération et ajoute une extension de contrôle de cache. La directive modifiée signifie qu’en plus de tout cache non partagé, tout cache partagé uniquement par les membres de la communauté nommée « DEV » peut mettre en cache la réponse.

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

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

Remarques

L’extension de nom de champ est valide uniquement lorsqu’elle est utilisée avec les private directives ou no-cache . Pour plus d’informations, consultez RFC 2616 : Protocole de transfert hypertexte -- HTTP/1.1, disponible sur le site Web du World Wide Web Consortium (W3C).

Cette méthode lève une exception d’argument non valide si des directives et des extensions incompatibles sont combinées.

SetCacheability est introduit dans le .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances.

S’applique à