HttpCachePolicy.VaryByContentEncodings 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取用于区分输出缓存的 Content-Encoding
标头列表。
public:
property System::Web::HttpCacheVaryByContentEncodings ^ VaryByContentEncodings { System::Web::HttpCacheVaryByContentEncodings ^ get(); };
public System.Web.HttpCacheVaryByContentEncodings VaryByContentEncodings { get; }
member this.VaryByContentEncodings : System.Web.HttpCacheVaryByContentEncodings
Public ReadOnly Property VaryByContentEncodings As HttpCacheVaryByContentEncodings
属性值
指定将用于选择缓存的响应的 Content-Encoding
标头对象。
示例
以下示例演示如何为要从输出缓存中提供的页面启用动态压缩响应。 可接受的编码为“gzip”,并使用 VaryByContentEncodings
@ OutputCache 指令的属性进行设置。 如果承载页面的 Web 服务器未启用动态压缩,则输出缓存将没有基于指定内容编码的缓存响应。
<%@ Page Language="C#" %>
<%@ OutputCache VaryByParam="none" Duration="10" VaryByContentEncodings="gzip" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>Varying Output Cache By Content Encoding</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<%= DateTime.Now.ToString() %>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ OutputCache VaryByParam="none" Duration="10" VaryByContentEncodings="gzip" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>Varying Output Cache By Content Encoding</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<%= DateTime.Now.ToString() %>
</div>
</form>
</body>
</html>
注解
该属性返回一个内容编码标头列表,这些 VaryByContentEncodings 标头表示压缩方案,以改变输出缓存。 Caching动态压缩的响应意味着,在资源的第一次请求期间,仅产生一次压缩成本。
该 VaryByContentEncodings 属性与请求的标头一起使用 Accept-Encoding
,以确定如何为动态压缩的不同内容编码提供缓存响应。 Accept-Encoding标头列出了客户端可以解压缩的编码。
将缓存设置为因内容编码而异时,它允许响应因标头中的 Accept-Encoding
值间接变化。 处理请求时, Accept-Encoding
将检查标头,并识别第一个可接受的编码,并用于执行以下操作之一:
如果在列表中找到 VaryByContentEncodings 匹配的编码并且存在缓存的响应,则会发送缓存的响应。
如果在列表中找到 VaryByContentEncodings 匹配的编码,但缓存的响应不存在,则会生成并插入缓存中的响应。
如果在列表中找不到 VaryByContentEncodings 匹配的编码,则缓存将搜索非编码响应,也称为标识响应。 如果找到非编码响应,则会发送该响应。 否则,会在缓存中生成、发送和存储新的非编码响应。
有关该属性的详细信息 VaryByContentEncodings ,请参阅“RFC 2616:超文本传输协议 -- HTTP/1.1”,该协议在 万维网联盟 (W3C) 网站上可用。 有关内容编码的信息位于“标头字段定义”第 14 节中。
可以使用 @ OutputCache 指令的属性来设置VaryByContentEncodings属性VaryByContentEncodings
。 还可以将缓存配置文件添加到 Web.config 文件中的 outputCacheProfile 元素。
VaryByContentEncodings.NET Framework版本 3.5 中引入。 有关详细信息,请参见版本和依赖关系。