Класс PagesSection
Представляет <pages> раздел файла Web.config.
Синтаксис
class PagesSection : ConfigurationSectionWithCollection
Методы
В следующей таблице перечислены методы, предоставляемые классом PagesSection .
| Имя | Описание |
|---|---|
| Добавление | (Наследуется от ConfigurationSectionWithCollection.) |
| Очистить | (Является наследником ConfigurationSectionWithCollection) |
| Get | (Является наследником ConfigurationSectionWithCollection) |
| GetAllowDefinition | (Наследуется от ConfigurationSection.) |
| GetAllowLocation | (Является наследником ConfigurationSection) |
| Удалить | (Является наследником ConfigurationSectionWithCollection) |
| RevertToParent | (Является наследником ConfigurationSection) |
| SetAllowDefinition | (Является наследником ConfigurationSection) |
| SetAllowLocation | (Является наследником ConfigurationSection) |
Свойства
В следующей таблице перечислены свойства, предоставляемые классом PagesSection .
| Имя | Описание |
|---|---|
AsyncTimeout |
Значение для чтения и записи datetime , указывающее время ожидания страницы для выполнения асинхронных задач. Значение по умолчанию — 45 секунд. |
AutoEventWireup |
Значение для чтения и записи boolean . true, если события для страниц ASP.NET автоматически подключаются к функциям обработки событий; в противном случае false. Значение по умолчанию — true. Примечание: Если это свойство имеет значение true, ASP.NET не требует, чтобы события указывали обработчики событий, такие как Page_Load или Page_Init. Это означает, что ключевое Handles слово в Visual Basic не требуется в скрипте сервера на странице веб-формы. По умолчанию при создании веб-приложения ASP.NET в Visual Studio значение AutoEventWireup свойства устанавливается false в aspx-странице или элементе управления ASCX, а обработчики событий не создаются автоматически. Не устанавливайте значение AutoEventWireup , true если производительность является ключевым фактором. |
Buffer |
Значение для чтения и записи boolean . true, если страницы .aspx и элементы управления .ascx используют буферизацию ответов; в противном случае false. Значение по умолчанию — true. Примечание: Если включена буферизация ответов, выходные данные страницы или элемента управления помещается в буфер до тех пор, пока не будет обработана вся страница или элемент управления. Не устанавливайте для этого свойства значение , true если производительность является ключевым фактором. |
CompilationMode |
Перечисление для чтения и записи sint32 , указывающее, компилируются ли aspx-страницы и элементы управления ASCX во время выполнения. Возможные значения перечислены далее в разделе Примечания. |
Controls |
Значение TagPrefixInfo , содержащее сведения о конфигурации для пользовательских и пользовательских элементов управления. |
EnableEventValidation |
Значение boolean. true значение , если должна быть выполнена проверка событий; в противном случае — false. Значение по умолчанию — true.Механизм проверки событий устраняет риск несанкционированных запросов обратной передачи и обратных вызовов из элемента управления. Во время отрисовки элемент управления регистрирует свои события, а затем проверяет только те события, которые могут быть вызваны в элементе управления во время обратного запроса или обратного вызова. Все управляемые событиями элементы управления в ASP.NET теперь используют эту функцию по умолчанию. Однако вы можете вернуться к поведению платформа .NET Framework версии 1.0, отключив проверку событий для веб-приложения. Примечание: Базовый элемент управления проверяет это свойство, чтобы определить, следует ли проверять события. Производный элемент управления не наследует этот базовый параметр элемента управления, поэтому по умолчанию он исключается из проверки событий. Вы по-прежнему можете указать ASP.NET выполнить проверку событий в производном элементе управления, добавив EnableEventValidation свойство в сам производный элемент управления и задав ему значение true. |
EnableSessionState |
Значение для чтения и записи sint32 , указывающее, включено ли состояние сеанса. Возможные значения перечислены далее в разделе Примечания. |
EnableViewState |
Значение для чтения и записи boolean . true Значение , если состояние просмотра включено; false. В противном случае значение по умолчанию — true. |
EnableViewStateMac |
Значение для чтения и записи boolean . true если ASP.NET следует выполнить проверку подлинности сообщения в состоянии просмотра страницы при обратной отправке страницы из клиента; в противном случае — false. Значение по умолчанию — true. Примечание: По соображениям безопасности этому свойству всегда должно быть присвоено значение true. |
Location |
(Наследуется от ConfigurationSection.) Свойство ключа. |
MaintainScrollPositionOnPostBack |
Значение для чтения и записи boolean . true Значение , если позиция прокрутки страницы браузера должна поддерживаться после обратной передачи; в противном случае — false. Значение по умолчанию — false. |
MasterPageFile |
Значение для чтения и записи string , указывающее ссылку на главную страницу приложения. Строка может содержать относительный или абсолютный путь. |
MaxPageStateFieldLength |
Значение для чтения и записи sint32 , указывающее максимальное количество символов, которое может содержаться в одном поле состояния представления. Значение по умолчанию — –1 (ограничение не указано).Если длина хранимых данных превышает указанное значение, данные делятся между несколькими полями состояния представления. |
Namespaces |
Значение NamespaceInfo , содержащее ссылки на пространство имен, которые автоматически импортируются на все страницы веб-приложения. Это делает классы указанных пространств имен доступными для использования на странице. |
PageBaseType |
Значение для чтения и записи string , указывающее класс кода программной части, который страницы ASPX наследуют по умолчанию. Значение по умолчанию — "System.Web.UI.Page". |
PageParserFilterType |
Значение для чтения и записи string , указывающее тип фильтра средства синтаксического анализа. Фильтр синтаксического анализа — это экземпляр класса System.Web.UI.PageParserFilter . Во время выполнения процесс компиляции страниц вызывает фильтр средства синтаксического анализа, чтобы проверить наличие изменений в исходном коде перед анализом страницы. |
Path |
(Наследуется от ConfigurationSection.) Свойство ключа. |
SectionInformation |
(Является наследником ConfigurationSection) |
SmartNavigation |
Значение для чтения и записи boolean . true, если навигация включена. В противном случае — false. Значение по умолчанию — false. Примечание: Для интеллектуальной навигации требуется Microsoft Internet Explorer 5.5, 6 или 7. |
StyleSheetTheme |
Значение для чтения и записи string , указывающее имя темы таблицы стилей ASP.NET. |
TagMapping |
Значение TagMapInfo , содержащее инструкции повторного сопоставления тегов конфигурации. Это свойство позволяет переназначить типы тегов во время компиляции. Повторное сопоставление приводит к использованию сопоставленного типа вместо исходного типа тега для всех страниц и элементов управления в приложении ASP.NET в области файла конфигурации. |
Theme |
Значение для чтения и записи string , указывающее имя темы страницы ASP.NET. |
UserControlBaseType |
Значение для чтения и записи string , указывающее класс кода программной части, который пользователь управляет наследованием по умолчанию. Значение по умолчанию — System.Web.UI.UserControl. |
ValidateRequest |
Значение для чтения и записи boolean . true Если ASP.NET выполняет проверку запроса для всех входных данных из браузера; в противном случае — false. Значение по умолчанию — true.Проверка запроса выполняется путем сравнения входных данных со списком потенциально опасных значений. При совпадении ASP.NET вызывает исключение System.Web.HttpRequestValidationException. |
ViewStateEncryptionMode |
Перечисление чтения и записи sint32 , указывающее режим шифрования, который ASP.NET использует для значений состояния представления. Возможные значения перечислены далее в разделе Примечания. |
используются подклассы ;
Этот класс не содержит подклассов.
Комментарии
В следующей таблице перечислены возможные CompilationMode значения для свойства . Значение по умолчанию — 2 (Always).
| Значение | Ключевое слово | Описание |
|---|---|---|
| 0 | Auto |
ASP.NET не компилирует страницу, если это возможно. |
| 1 | Never |
Страница или элемент управления никогда не компилируются динамически. Этот параметр повышает производительность за счет дисквалификации указанной страницы из процесса компиляции. Если страница содержит блок скрипта или конструкцию кода, требующую компиляции, ASP.NET возвращает ошибку и страница не выполняется. |
| 2 | Always |
Страница должна компилироваться в любом случае. |
В следующей таблице перечислены возможные EnableSessionState значения для свойства . Значение по умолчанию — 2 (True).
| Значение | Ключевое слово | Описание |
|---|---|---|
| 0 | False |
Состояние сеанса отключено. |
| 1 | ReadOnly |
Состояние сеанса доступно только для чтения. |
| 2 | True |
Состояние сеанса включено. |
В следующей таблице перечислены возможные ViewStateEncryptionMode значения для свойства . Значение по умолчанию — 0 (Auto).
| Значение | Ключевое слово | Описание |
|---|---|---|
| 0 | Auto |
Сведения о состоянии представления шифруются, если элемент управления запрашивает шифрование путем вызова метода System.Web.UI.Page.RegisterRequiresViewStateEncryption . |
| 1 | Always |
Информация о состоянии просмотра всегда закодирована. |
| 2 | Never |
Состояние просмотра никогда не кодируется, даже если того требует элемент управления. |
Иерархия наследования
ConfigurationSectionWithCollection
PagesSection
Требования
| Тип | Описание |
|---|---|
| клиент | — IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 на Windows 10 |
| Сервер | — IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 на Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016 |
| Продукт | — IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| MOF-файл | WebAdministration.mof |
См. также:
Microsoft.Web.Management.Client.Win32.ModulePage.Microsoft.Web.Management.Client.IModulePage.Initialize
System.Web.UI.Page.RegisterRequiresViewStateEncryption
System.Web.Configuration.PagesSectionSystem.Web.HttpRequestValidationException
Класс AspSession
Класс ConfigurationSectionWithCollection
Класс NamespaceInfo
Класс SessionPageStateSection
Класс SessionStateSection
Класс TagMapElement
Класс TagMapInfo
Класс TagPrefixElement
Класс TagPrefixInfo
Перечисление CompilationMode