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

Статья
11/16/2008

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

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

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

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

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

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

Атрибуты

Атрибут	Описание
asyncTimeout	Необязательный атрибут TimeSpan. Указывает количество секунд ожидания завершения асинхронной обработки асинхронным обработчиком. Этот атрибут не использовался до .NET Framework версии 2.0. Значение по умолчанию — "0:00:45" (45 секунд).
autoEventWireup	Необязательный атрибут Boolean. Указывает, разрешаются ли по умолчанию события страниц. Это происходит в случае использования атрибута autoevent wireup, что означает, что система автоматически присоединит методы установки определенной подписи (например, page_Load). Дополнительные сведения см. в разделе Модель событий серверного веб-элемента управления ASP.NET. Значение по умолчанию — True.
buffer	Необязательный атрибут Boolean. Указывает, будет ли URL-ресурс использовать буферизацию ответных сообщений. Значение по умолчанию — True.
compilationMode	Необязательный атрибут CompilationMode. Указывает, будет ли страница или элемент управления ASP.NET скомпилированы во время выполнения. Атрибут compilationMode не использовался до .NET Framework 2.0. Он может принимать одно из следующих возможных значений. Значение по умолчанию — Always. ЗначениеОписание Always Страница всегда должна быть скомпилирована. Auto ASP.NET не будет компилировать страницу, если это возможно. Never Станица или элемент управления не должны динамически компилироваться. Если на странице содержится блок сценария или конструкция кода, которые должны быть скомпилированы, ASP.NET вернет ошибку и страница запущена не будет
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	Определяет коллекцию типов тегов, которые ставятся в соответствие другим типам тегов во время компиляции.

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

Элемент	Описание
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" 
   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, 5.1 или 6.0 .NET Framework версии 1.0, 1.1 или 2.0 Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

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

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

Атрибуты

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

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

Заметки

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

Пример

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

См. также

Задачи

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

Ссылки

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

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