Бөлісу құралы:


HttpCachePolicy.VaryByContentEncodings Свойство

Определение

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

<%@ 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. Дополнительные сведения см. в статье Версии и зависимости платформы .NET Framework.

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

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