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


Элемент add для элемента outputCacheProfiles для элемента caching (схема параметров ASP.NET)

Обновлен: Ноябрь 2007

Добавляет объект OutputCacheProfile в коллекцию конфигурации. На профили кэша возможно ссылаться только из директивы @ OutputCache для страниц. Профили не поддерживаются на пользовательских и серверных элементах управления.

Элемент configuration (схема общих параметров)
  Элемент system.web (схема параметров ASP.NET)
    Элемент caching (схема параметров ASP.NET)
      Элемент outputCacheSettings для элемента caching (схема параметров ASP.NET)
        Элемент outputCacheProfiles для элемента outputCacheSettings для элемента caching (схема параметров ASP.NET)
          Элемент add для элемента outputCacheProfiles для элемента caching (схема параметров ASP.NET)

<add name="String" 
     enabled="true|false" 
     duration="number" 
     location="Any|Client|Downstream|Server|None|ServerAndClient" 
     sqlDependency="String" 
     varyByCustom="String" 
     varyByControl="String" 
     varyByHeader="String" 
     varyByParam="String" 
     noStore="true|false" />

Атрибуты и элементы

В следующих разделах описываются атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут

Описание

name

Обязательный строковый (String) атрибут.

Задает уникальное имя профиля кэша.

enabled

Необязательный атрибут Boolean.

Включает кэширование выходных данных для профиля.

duration

Необязательный атрибут TimeSpan.

Задает продолжительность времени в секундах для хранения страницы в кэше.

location

Необязательный атрибут Int32.

Определяет допустимое место хранения кэшированного ответа.

sqlDependency

Необязательный атрибут String.

Задает зависимость кэша SQL уровня страницы.

varyByCustom

Необязательный атрибут String.

Задает строку, используемую при вызове varyByCustom на странице.

varyByControl

Необязательный атрибут String.

Задает идентификатор элемента управления, подлежащего кэшированию и использованию при вызове varyByControl. Можно также задать список идентификаторов, разделенных точкой с запятой.

varyByHeader

Необязательный атрибут String.

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

varyByParam

Необязательный атрибут String.

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

noStore

Необязательный атрибут Boolean.

Задает значение, указывающее, отправлена ли директива "Cache-Control: no-store" в ответ для кэшированных страниц.

Дочерние элементы

Нет.

Родительские элементы

Элемент

Описание

configuration

Обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework.

system.web

Определяет корневой элемент для параметров конфигурации ASP.NET в файле конфигурации. Содержит элементы конфигурации для настройки веб-приложений ASP.NET и управления поведением этих приложений.

caching

Задает параметры кэширования для веб-приложения.

outputCacheSettings

Определяет параметры кэша выходных данных, которые можно использовать на страницах приложения ASP.NET.

outputCacheProfiles

Содержит группы параметров кэша, которые можно использовать на страницах для определения директивы OutputCache.

Заметки

Конфигурация по умолчанию

Следующий элемент по умолчанию add не задан явно в файле конфигурации компьютера или в корневом файле Web.config, но является конфигурацией по умолчанию, возвращаемой приложением в .NET Framework версии 2.0.

<add name = "" 
  enabled = "true" 
  duration = "-1" 
  location = "" 
  sqlDependency = "" 
  varyByCustom = "" 
  varyByControl = "" 
  varyByHeader = "" 
  varyByParam = "" 
  noStore = "false"/>

Пример

В следующем примере страница кэшируется на сервере только в течение одной минуты. Сохраняются разные версии страницы в зависимости от типа обозревателя и основной версии.

<outputCacheSettings>
  <outputCacheProfiles>
    <add name="ServerOnly" 
         duration="60" 
         varyByCustom="browser" 
         location="Server" />
  </outputCacheProfiles>
</outputCacheSettings>

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

<%@ OutputCache CacheProfile="ServerOnly" %>

Дополнительные сведения см. в разделе @ OutputCashe.

Сведения об элементе

Обработчик раздела конфигурации

System.Web.Configuration.OutputCacheSettingsSection

Член конфигурации

OutputCacheSettingsSection.OutputCacheProfiles

Настраиваемые расположения

Machine.config

Файл Web.config корневого уровня

Файл Web.config уровня приложения

Требования

Службы IIS версий 5.0, 5.1 и 6.0

..NET Framework версии 2.0

Visual Studio 2005

См. также

Задачи

Пошаговое руководство. Использование кэширования выходных данных для улучшения производительности веб-узла

Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

Основные понятия

Общие сведения о кэшировании в ASP.NET

Иерархия и наследование файла конфигурации ASP.NET

Настройка обеспечения безопасности ASP.NET

Сценарии конфигурации ASP.NET

Ссылки

Элемент system.web (схема параметров ASP.NET)

Элемент configuration (схема общих параметров)

Элемент caching (схема параметров ASP.NET)

Элемент outputCacheSettings для элемента caching (схема параметров ASP.NET)

Элемент outputCacheProfiles для элемента outputCacheSettings для элемента caching (схема параметров ASP.NET)

System.Configuration

System.Web.Configuration

Другие ресурсы

Общие параметры конфигурации (ASP.NET)

Параметры конфигурации ASP.NET

Администрирование веб-узлов ASP.NET

Файлы конфигурации ASP.NET

Конфигурационный интерфейс API ASP.NET