HttpCachePolicy.SetCacheability 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

設定 Cache-Control HTTP 標頭。 Cache-Control HTTP 標頭控制文件如何在網路上進行快取。

多載

SetCacheability(HttpCacheability)	將 Cache-Control 標頭設定為其中一個 HttpCacheability 值。
SetCacheability(HttpCacheability, String)	將 Cache-Control 標頭設定為其中一個 HttpCacheability 值，並且附加擴充功能到指示詞。

SetCacheability(HttpCacheability)

將 Cache-Control 標頭設定為其中一個 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)

參數

cacheability

HttpCacheability

HttpCacheability 列舉值。

例外狀況

ArgumentOutOfRangeException

cacheability 不是其中一個列舉值。

範例

下列程式碼範例示範如何將 標頭設定 Cache-Control 為 的 no-cache 列舉值。

Response.Cache.SetCacheability(HttpCacheability.NoCache);

Response.Cache.SetCacheability(HttpCacheability.NoCache)

備註

SetCacheability.NET Framework 3.5 版引進。 如需詳細資訊，請參閱版本和相依性。

SetCacheability(HttpCacheability, String)

將 Cache-Control 標頭設定為其中一個 HttpCacheability 值，並且附加擴充功能到指示詞。

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)

參數

cacheability

HttpCacheability

要設定標頭的目標 HttpCacheability 列舉值。

field

String

加入標頭的快取控制項擴充功能。

例外狀況

ArgumentNullException

field 為 null。

ArgumentException

cacheability 不是 Private 或 NoCache。

範例

下列程式碼範例示範標頭如何 Cache-Control 設定為列舉值 private ，並新增快取控制項延伸模組。 已修改的 指示詞表示除了任何非共用快取之外，只有名為 「DEV」 之社群成員共用的任何快取都可能會快取回應。

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

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

備註

功能變數名稱延伸模組只有在搭配 private 或 no-cache 指示詞使用時才有效。 如需詳細資訊，請參閱 RFC 2616：超文字傳輸通訊協定 -- 可在萬維網聯盟 (W3C) 網站上取得的 HTTP/1.1。

如果合併不相容的指示詞和延伸模組，這個方法將會擲回不正確引數例外狀況。

SetCacheability.NET Framework 3.5 版引進。 如需詳細資訊，請參閱版本和相依性。