Поделиться через

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 . Если веб-сервер, на котором размещена страница, не включает динамическое сжатие, выходной кэш не будет иметь кэшированный ответ, основанный на указанной кодировке содержимого.

<%@ 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 возвращает список заголовков Content-Encoding, представляющих схемы сжатия, чтобы изменить выходной кэш. Кэширование динамически сжатых ответов означает, что стоимость сжатия взимается только один раз во время первого запроса ресурса.

Свойство VaryByContentEncodings используется с Accept-Encoding заголовком запроса, чтобы определить, как обслуживать кэшированные ответы для различных кодировок содержимого, которые динамически сжимаются. Заголовок Accept-Encoding перечисляет кодировки, которые клиент может распаковыть.

При настройке кэша в зависимости от кодировки содержимого он позволяет ответу косвенно различаться по значению в заголовке Accept-Encoding . При обработке Accept-Encoding запроса заголовок проверяется, а первый допустимый кодирование определяется и используется для выполнения одного из следующих действий:

  • Если в списке найдена VaryByContentEncodings соответствующая кодировка, а кэшированный ответ существует, отправляется кэшированный ответ.

  • Если в списке найдена VaryByContentEncodings соответствующая кодировка, но кэшированный ответ не существует, создается ответ и вставляется в кэш.

  • Если в списке не найдена VaryByContentEncodings кодировка, кэш выполняет поиск некодированного ответа, также называемого ответом удостоверения. Если найден некодированный ответ, он отправляется. В противном случае новый некодированный ответ создается, отправляется и сохраняется в кэше.

Дополнительные сведения об VaryByContentEncodings этом свойстве см. в разделе "RFC 2616: протокол hypertext Transfer Protocol - HTTP/1.1", который доступен на веб-сайте консорциума W3C. Сведения о кодировке содержимого приведены в разделе 14 "Определения полей заголовка".

Свойство можно задать VaryByContentEncodings с помощью VaryByContentEncodings атрибута директивы @OutputCache . Вы также можете добавить профиль кэша в элемент outputCacheProfile в файле Web.config.

VaryByContentEncodings представлен в .NET Framework версии 3.5. Дополнительные сведения см. в разделе "Версии и зависимости".

Применяется к

См. также раздел