PagesSection 类
表示 Web.config 文件的 <pages> 节。
语法
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 值。 如果 ASP.NET 页面的事件自动连接到事件处理函数，则为 true；否则为 false。 默认为 true。 注意：当此属性为 true 时，ASP.NET 不需要事件来指定事件处理程序，例如 Page_Load 或 Page_Init。 这意味着 Web Forms 页的服务器脚本中不需要 Visual Basic 中的 Handles 关键字。 默认情况下，在 Visual Studio 中创建 ASP.NET Web 应用程序时，.aspx 页或 .ascx 控件中的 AutoEventWireup 属性的值将设置为 false，并且不会自动创建事件处理程序。 如果性能是一个关键考虑因素，请不要将 AutoEventWireup 设置为 true。 |
Buffer |
一个读/写 boolean 值。 如果 .aspx 页和 .ascx 控件使用响应缓冲，则为 true；否则为 false。 默认为 true。 注意：打开响应缓冲后，页面或控件输出将缓冲到处理整个页面或控件之后。 如果性能是一个关键考虑因素，请不要将此属性设置为 true。 |
CompilationMode |
一个读/写 sint32 枚举，指定在运行时是否编译 .aspx 页和 .ascx 控件。 后文的“注解”部分列出了可能的值。 |
Controls |
一个 TagPrefixInfo 值，包含自定义控件和用户控件的配置信息。 |
EnableEventValidation |
一个 boolean 值。 如果应执行事件验证，则为 true；否则为 false。 默认为 true。事件验证机制消除了来自控件的未经授权的回发请求和回调的风险。 在呈现期间，控件注册其事件，然后仅验证那些在回发请求或回调期间可在控件上引发的特定事件。 默认情况下，ASP.NET 中的所有事件驱动控件现在都使用此功能。 但可以选择通过禁用 Web 应用程序的事件验证来恢复 .NET Framework 版本 1.0 的行为。 注意：基本控件检查此属性以确定它是否应验证事件。 派生控件不继承此基本控件设置，因此默认情况下它不受事件验证的豁免。 您仍然可以指示 ASP.NET 对派生控件执行事件验证，方法是将 EnableEventValidation 属性添加到派生控件本身并将其设置为 true。 |
EnableSessionState |
一个读/写 sint32 值，指定是否启用会话状态。 后文的“注解”部分列出了可能的值。 |
EnableViewState |
一个读/写 boolean 值。 如果启用了视图状态，则为 true；否则为 false.。默认值为 true。 |
EnableViewStateMac |
一个读/写 boolean 值。 如果从客户端回发页时，ASP.NET 应对页的视图状态运行消息身份验证检查，则为 true，否则为 false。 默认为 true。 注意：出于安全原因，此属性应始终设置为 true。 |
Location |
（继承自 ConfigurationSection。）一个键属性。 |
MaintainScrollPositionOnPostBack |
一个读/写 boolean 值。 如果浏览器页面滚动位置应在回发后保持不变，则为 true；否则为 false。 默认为 false。 |
MasterPageFile |
一个读/写 string 值，指定对应用程序的母版页的引用。 字符串可以包含相对路径或绝对路径。 |
MaxPageStateFieldLength |
一个读/写 sint32 值，指定单个视图状态字段可以包含的最大字符数。 默认值为 –1（未指定限制）。如果存储数据的长度超过指定的值，则数据在多个视图状态字段之间拆分。 |
Namespaces |
一个 NamespaceInfo 值，包含自动导入到 Web 应用程序的所有页中的命名空间引用。 这使得指定命名空间的类可用于页上。 |
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 值。 如果 ASP.NET 对浏览器的所有输入执行请求验证，则为 true，否则为 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
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10 上的 IIS 10.0 |
| 服务器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016 上的 IIS 10.0 |
| 产品 | - 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 枚举