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

Статья
08/11/2011

Глобально определяет специфические для страницы параметры конфигурации, такие как директивы ASP.NET для страниц и элементов управления, которые находятся в области действия файла конфигурации.

<pages     
   asyncTimeout="number"
   autoEventWireup="[True|False]"
   buffer="[True|False]"
   clientIDMode="[AutoID|Predictable|Static]"
   compilationMode="[Always|Auto|Never]" 
   controlRenderingCompatibilityVersion="[3.5|4.0]"
   enableEventValidation="[True|False]"
   enableSessionState="[True|False|ReadOnly]"
   enableViewState="[True|False]"
   enableViewStateMac="[True|False]"
   maintainScrollPositionOnPostBack="[True|False]" 
   masterPageFile="file path" 
   maxPageStateFieldLength="number" 
   pageBaseType="typename, assembly"
   pageParserFilterType="string" 
   smartNavigation="[True|False]"
   styleSheetTheme="string"
   theme="string"
   userControlBaseType="typename"
   validateRequest="[True|False]"
   viewStateEncryptionMode="[Always|Auto|Never]" 
>
   <controls>...</controls>
   <namespaces>...</namespaces>
   <tagMapping>...</tagMapping>
   <ignoreDeviceFilters>...</ignoreDeviceFilters>
</pages>

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

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

Атрибуты

Атрибут	Описание
asyncTimeout	Необязательный атрибут элемента TimeSpan. Указывает количество секунд ожидания завершения асинхронной обработки асинхронным обработчиком. Этот атрибут не использовался до .NET Framework версии 2.0. Значение по умолчанию — "0:00:45" (45 секунд).
autoEventWireup	Необязательный атрибут элемента Boolean. Указывает, разрешаются ли по умолчанию события страниц. Это происходит в случае использования автоматического события установки, что означает, что система автоматически присоединит методы установки определенной сигнатуры (например, Page_Load). Дополнительные сведения см. в разделе Модель событий серверного веб-элемента управления ASP.NET. Значение по умолчанию — True.
buffer	Необязательный атрибут элемента Boolean. Указывает, будет ли URL-ресурс использовать буферизацию ответных сообщений. Значение по умолчанию — True.
clientIDMode	Задает алгоритм, используемый для формирования значений ClientID для элементов управления. Значение по умолчанию — Predictable. По умолчанию для элементов управления установлено значение Inherit. Соответственно, алгоритм по умолчанию для элементов управления на странице определяется параметром страницы ClientIDMode. Другое значение по умолчанию может быть в директиве @ Page на уровне страницы или в директиве @ Control пользовательского элемента управления. Дополнительные сведения об алгоритмах см. в разделах ClientIDMode и Идентификация серверного веб-элемента управления ASP.NET.
compilationMode	Необязательный атрибут элемента CompilationMode. Указывает, будет ли страница или элемент управления ASP.NET скомпилированы во время выполнения. compilationMode представляет собой новый атрибут в .NET Framework версии 2.0 Этот атрибут может принимать одно из следующих значений. По умолчанию используется значение Always. ЗначениеОписание Always Страница должна компилироваться в любом случае. Auto ASP.NET не будет компилировать страницу, если это возможно. Never Станица или элемент управления не должны компилироваться динамически. Если на странице содержится блок скрипта или конструкция кода, которые должны быть скомпилированы, ASP.NET вернет ошибку и страница запущена не будет
controlRenderingCompatibilityVersion	Указывает, каким образом элементы управления должны отображать HTML: так, как они это делали в предыдущей версии ASP.NET, или так, как это следует делать в текущей версии. Примечание controlRenderingCompatibilityVersion впервые появился в ASP.NET 4.Установка текущего номера версии имеет тот же эффект, что отсутствие установки значения.В любом случае элементы управления отображают HTML, как это разработано для текущей версии.Самой ранней версией, в которой можно задать значение этого атрибута, является версия 3.5. Дополнительные сведения см. в свойствах PagesSection.ControlRenderingCompatibilityVersion и Control.RenderingCompatibility.
enableEventValidation	Указывает, выполняют ли страницы и элементы управления проверку событий обратного вызова и обратной передачи. Значение по умолчанию — True.
enableSessionState	Необязательный атрибут элемента String. Указывает требования к состоянию сеанса для ресурсов, находящихся в области действия файла конфигурации. Атрибут enableSessionState может принимать одно из следующих значений. Значение по умолчанию — True. ЗначениеОписание False Указывает, что состояние сеанса отключено. ReadOnly Указывает, что состояние сеанса недоступно для записи. True Указывает, что состояние сеанса включено.
enableViewState	Необязательный атрибут элемента Boolean. Указывает, включено или состояние отображения и сохраняется ли оно в запросах к страницам. Значение по умолчанию — True.
enableViewStateMac	Необязательный атрибут элемента Boolean. Указывает, нужно ли в ASP.NET использовать код подлинности сообщения (КПС) для состояния отображения страницы при получении ответа на запрос от клиента. В случае значения True производится проверка зашифрованного состояния отображения, чтобы гарантировать его неизменность на стороне клиента. Значение по умолчанию — True.
maintainScrollPositionOnPostBack	Необязательный атрибут элемента Boolean. Указывает, нужно ли вернуть пользователя на прежнее место в клиентском обозревателе при обратной отправке страницы на сервер. В случае значения False пользователь возвращается в верхнюю часть страницы. Этот атрибут не использовался до .NET Framework 2.0. По умолчанию используется значение False.
masterPageFile	Необязательный атрибут элемента String. Указывает путь к главной странице, являющийся относительным по отношению к локальному файлу конфигурации. Страницы, на которых атрибуту masterPageFile задано значение True, должны содержать элемент управления Content в качестве элемента верхнего уровня. Этот атрибут не использовался до .NET Framework 2.0. Значение по умолчанию — пустая строка ("").
maxPageStateFieldLength	Необязательный атрибут элемента Int32. Указывает максимальную длину в символах для поля состояния для страницы. Если значение является положительным числом, поле состояния просмотра, отправленное в клиентский обозреватель, разделяется на блоки, причем размер каждого блока меньше, чем указано в атрибуте maxPageStateFieldLength. Если значение — отрицательное число, поле состояния просмотра не должно разделяться на блоки. Этот атрибут не использовался до .NET Framework 2.0. По умолчанию используется значение "-1".
pageBaseType	Необязательный атрибут элемента String. Указывает базу, используемую в случае работы только с автономными страницами. Он переопределяется атрибутом inheritsв автономном файле. По умолчанию используется "System.Web.UI.Page".
pageParserFilterType	Необязательный атрибут элемента String. Указывает имя типа фильтра, используемого анализатором ASP.NET для определения того, является ли элемент допустимым на странице во время синтаксического анализа. Фильтр должен быть производным от класса PageParserFilter. Этот атрибут не использовался до .NET Framework 2.0. Значение по умолчанию — пустая строка ("").
smartNavigation	Необязательный атрибут элемента Boolean. Указывает, включен ли режим улучшенных переходов. Для режима улучшенных переходов требуется Microsoft Internet Explorer версии 5.5 или более поздней. Если этот режим включен, пользователь получает следующие преимущества. Отсутствует мигание, связанное с переходами. Сохраняется положение полосы прокрутки между страницами. Сохраняется фокус элемента между страницами. В истории обозревателя сохраняется только последнее состояние страницы. Этот атрибут не использовался до .NET Framework 2.0, вместо него использовался атрибут maintainScrollPositionOnPostBack. По умолчанию используется значение False.
styleSheetTheme	Необязательный атрибут элемента String. Указывает имя папки "именованной темы", которое будет использоваться для применения до объявления элементов управления в отличие от атрибута темы, определяющего применимую тему после объявления элемента управления. Этот атрибут не использовался до .NET Framework 2.0. Значение по умолчанию — пустая строка ("").
theme	Необязательный атрибут элемента String. Указывает имя темы, используемой для страниц, находящихся в области действия файла конфигурации. Указанная тема должна существовать в виде приложения или глобальной темы. Если тема не существует, создается исключение HttpException. Этот атрибут не использовался до .NET Framework 2.0. Значение по умолчанию — пустая строка ("").
userControlBaseType	Необязательный атрибут элемента String. Указывает базу, используемую в случае работы только с автономными страницами. По умолчанию используется "System.Web.UI.UserControl".
validateRequest	Необязательный атрибут элемента Boolean. Указывает, что при использовании ASP.NET производится проверка всех поступивших от обозревателя входных данных для выявления потенциально небезопасных. В случае значения True выполняется проверка запроса путем сравнения всех входных данных со списком потенциально небезопасных значений. Если найдено соответствие, то при использовании ASP.NET создается исключение HttpRequestValidationException. Значение по умолчанию — True.
viewStateEncryptionMode	Необязательный атрибут элемента ViewStateEncryptionMode. Указывает режим шифрования состояния отображения. Свойство ViewStateEncryptionMode переопределяет этот атрибут, заданный в файле конфигурации. Этот атрибут может принимать одно из следующих значений. ЗначениеОписание Always Состояние отображения всегда шифруется. Auto Состояние отображения шифруется, если того требует элемент управления. Never Состояние отображения никогда не шифруется, даже если того требует элемент управления. Этот атрибут не использовался до .NET Framework 2.0. По умолчанию используется значение Auto.

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

Элемент	Описание
controls	Определяет коллекцию директив регистрации и пространства имен, где находятся префиксы тегов.
namespaces	Определяет коллекцию директив импорта, используемых в процессе предварительной компиляции сборки.
tagMapping	Определяет коллекцию типов тегов, которые ставятся в соответствие другим типам тегов во время компиляции.
ignoreDeviceFilters	Определяет коллекцию элементов устройства, которые браузер должен игнорировать при отрисовке страницы. Дополнительные сведения см. в разделе IgnoreDeviceFilters.

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

Элемент	Описание
configuration	Необходимый корневой элемент любого файла конфигурации, который используется средой CLR и приложениями платформы .NET Framework.
system.web	Задает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации и содержит элементы конфигурации для настройки веб-приложений ASP.NET и управления работой этих приложений.

Заметки

Элемент pages определяет специфические для страницы параметры конфигурации. Данный раздел конфигурации поддерживает глобальную настройку определенных директив страниц и элементов управления ASP.NET для всех страниц и элементов управления, находящихся в области действия файла конфигурации. Сюда входят следующие директивы уровня страницы, которые задают параметры, используемые компиляторами страниц и пользовательских элементов управления при обработке файла страницы Web Forms (.aspx) и файла пользовательского элемента управления (.ascx) в ASP.NET.

Директива @ Page (@ Page).
Директива @ Import (@ Import) с помощью дочернего элемента namespaces.
Директива @ Register (@ Register) с помощью дочернего элемента controls.

Элемент pages обеспечивает поддержку сопоставления типов тегов другим типам тегов во время выполнения с помощью элемента tagMapping.

Примечание
Добавление директивы @ Page на главную страницу не допускает использование одного и того же объявления директивы на страницах, зависящих от главной.Вместо этого для глобального определения директив страниц следует применять элемент конфигурации pages.

Добавление директивы @ Page на главную страницу не допускает использование одного и того же объявления директивы на страницах, зависящих от главной.Вместо этого для глобального определения директив страниц следует применять элемент конфигурации pages.

Параметры по умолчанию

Следующий установленный по умолчанию элемент pages не задается явно ни в файле Machine.config, ни в корневом файле Web.config. Однако это конфигурация, используемая по умолчанию, которая возвращена приложением. В корневой файл Web.config добавляются пространства имен и элементы управления.

<pages 
   buffer="true" 
   clientIDMode="AutoID" 
   enableSessionState="true" 
   enableViewState="true" 
   enableViewStateMac="true" 
   smartNavigation="false" 
   autoEventWireup="true" 
   pageBaseType="System.Web.UI.Page" 
   userControlBaseType="System.Web.UI.UserControl" 
   validateRequest="true" 
   masterPageFile="" 
   theme="" 
   styleSheetTheme="" 
   maxPageStateFieldLength="-1" 
   compilationMode="Always" 
   pageParserFilterType="" 
   viewStateEncryptionMode="Auto" 
   maintainScrollPositionOnPostBack="false" 
   asyncTimeout="45"
>
   <namespaces>
      <clear />
   </namespaces>
   <tagMapping>
      <clear />
   </tagMapping>
</pages>

Пример

В следующем примере кода показано, параметры конфигурации для нескольких страниц.

<configuration>
   <system.web>
      <pages buffer="true"
         enableSessionState="true"
         autoEventWireup="true"
         maintainScrollPositionOnPostBack="true"
         masterPageFile = "~/Masters/Page1.master" />
  </system.web>
</configuration>

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

Обработчик раздела конфигурации	PagesSection
Элемент конфигурации	Pages Page
Настраиваемые расположения	Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения Файл Web.config уровня виртуального или физического каталога
Требования	Microsoft IIS версии 5.0 или более поздней версии Платформа .NET Framework версии 1.0 или более поздней версии Microsoft Visual Studio 2003 или более поздней версии

См. также

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

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

Атрибуты

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

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

Заметки

Параметры по умолчанию

Пример

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

См. также

Задачи

Ссылки

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

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

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