HttpCachePolicy.VaryByContentEncodings 属性

  • 参考

定义

命名空间:
System.Web
程序集:
System.Web.dll

获取用于区分输出缓存的 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

属性值

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 中引入。 有关详细信息，请参见版本和依赖关系。

适用于

另请参阅