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


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

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

<outputCacheProfiles>
    <add.../>
    <clear />
    <remove.../>
</outputCacheProfiles>

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

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

Атрибуты

Отсутствует.

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

Элемент

Описание

add

Необязательный элемент.

Добавляет объект OutputCacheProfile в коллекцию конфигурации.

clear

Необязательный элемент.

Удаляет все объекты OutputCacheProfile из коллекции конфигураций.

remove

Необязательный элемент.

Удаляет из коллекции конфигурации объект OutputCacheProfile с указанным именем.

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

Элемент

Описание

configuration

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

system.web

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

caching

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

outputCacheSettings

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

Заметки

Настройки по умолчанию

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

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

Пример

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

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

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

<%@ OutputCache CacheProfile="ServerOnly" %>

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

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

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

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

Ссылки

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

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

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

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

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

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

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

System.Configuration

System.Web.Configuration

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

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

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

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

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

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

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

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

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

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

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