Элемент 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.
Сведения об элементе
Обработчик раздела конфигурации |
|
Член конфигурации |
|
Настраиваемые расположения |
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
Ссылки
Элемент system.web (схема параметров ASP.NET)
Элемент configuration (схема общих параметров)
Элемент caching (схема параметров ASP.NET)
Элемент outputCacheSettings для элемента caching (схема параметров ASP.NET)
Другие ресурсы
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET