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)

注解

.NET Framework 版本 3.5 中引入了 SetCacheability。 有关详细信息，请参阅 版本和依赖项。

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")

注解

字段名称扩展仅在与或no-cache指令一起使用private时才有效。 有关详细信息，请参阅 RFC 2616：超文本传输协议 -- 万维网联盟（W3C）网站上的 HTTP/1.1。

如果合并不兼容的指令和扩展，此方法将引发无效的参数异常。

.NET Framework 版本 3.5 中引入了 SetCacheability。 有关详细信息，请参阅 版本和依赖项。