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: протокол передачи гипертекста - HTTP/1.1", который доступен на веб-сайте консорциума W3C. Сведения о кодировках содержимого см. в разделе 14 "Определения полей заголовка".

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

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

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

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