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

Статья
11/16/2008

Обновлен: Ноябрь 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

См. также

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

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

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

Атрибуты

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

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

Заметки

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

Пример

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

См. также

Задачи

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

Ссылки

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

Дополнительные ресурсы