HttpCachePolicy.SetCacheability Methode

  • Referenz

Definition

Namespace:
System.Web
Assembly:
System.Web.dll

Legt den Cache-Control-HTTP-Header fest. Der Cache-Control-HTTP-Header steuert, wie Dokumente im Netzwerk zwischengespeichert werden.

Überlädt

SetCacheability(HttpCacheability)

Legt den Cache-Control-Header auf einen der Werte von HttpCacheability fest.
SetCacheability(HttpCacheability, String)

Legt den Cache-Control-Header auf einen der Werte von HttpCacheability fest und fügt eine Erweiterung an die Direktive an.

SetCacheability(HttpCacheability)

Legt den Cache-Control-Header auf einen der Werte von HttpCacheability fest.

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)

Parameter

cacheability
HttpCacheability

Ein HttpCacheability-Enumerationswert.

Ausnahmen

ArgumentOutOfRangeException

cacheability ist keiner der Enumerationswerte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der Cache-Control Header auf den aufgezählten Wert für no-cachefestgelegt wird.

Response.Cache.SetCacheability(HttpCacheability.NoCache);

Response.Cache.SetCacheability(HttpCacheability.NoCache)

Hinweise

SetCacheabilitywird in der .NET Framework Version 3.5 eingeführt. Weitere Informationen finden Sie unter Versionen und Abhängigkeiten.

Gilt für:

SetCacheability(HttpCacheability, String)

Legt den Cache-Control-Header auf einen der Werte von HttpCacheability fest und fügt eine Erweiterung an die Direktive an.

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)

Parameter

cacheability
HttpCacheability

Der HttpCacheability-Enumerationswert,auf den der Header festgelegt werden soll.

field
String

Die Erweiterung für die Cachesteuerung, die dem Header hinzugefügt werden soll.

Ausnahmen

ArgumentNullException

field ist null.

ArgumentException

cacheability ist nicht Private oder NoCache.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der Cache-Control Header auf den Enumerationswert private festgelegt wird und eine Cachesteuerungserweiterung hinzufügt. Die geänderte Direktive bedeutet, dass zusätzlich zu jedem nicht freigegebenen Cache jeder Cache, der nur von Mitgliedern der Community mit dem Namen "DEV" freigegeben wird, die Antwort zwischenspeichern kann.

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

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

Hinweise

Die Feldnamenerweiterung ist nur gültig, wenn sie mit der private -Anweisung oder no-cache verwendet wird. Weitere Informationen finden Sie unter RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1, verfügbar auf der W3C-Website (World Wide Web Consortium).

Diese Methode löst eine ungültige Argumentausnahme aus, wenn inkompatible Direktiven und Erweiterungen kombiniert werden.

SetCacheabilitywird in der .NET Framework Version 3.5 eingeführt. Weitere Informationen finden Sie unter Versionen und Abhängigkeiten.

Gilt für: