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

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

  • Статья

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

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

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

<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

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

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

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

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

Сценарии конфигурации 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

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