pages 元素（ASP.NET 设置架构）
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"
>
...
...
...
以下几节描述了属性、子元素和父元素。
| 属性 | 说明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
|
asyncTimeout |
可选的 TimeSpan 属性。 指定在异步处理过程中等待异步处理程序完成的时间（以秒为单位）。 此属性是 .NET Framework 2.0 版中的新属性。 默认值为 "0:00:45"（45 秒）。 |
||||||||
|
autoEventWireup |
可选的 Boolean 属性。 指定是否自动启用页事件。当出现自动事件连接时就是如此，它表示系统将自动连接特定签名的方法（如 page_Load）。有关更多信息，请参见 ASP.NET Web 服务器控件事件模型。 默认值为 True。 |
||||||||
|
buffer |
可选的 Boolean 属性。 指定 URL 资源是否使用响应缓冲。 默认值为 True。 |
||||||||
|
compilationMode |
可选的 CompilationMode 属性。 指定是否应当在运行时编译 ASP.NET 页或控件。 compilationMode 属性是 .NET Framework 2.0 中的新属性。此属性可以为下列可能值之一。默认值为 Always。
|
||||||||
|
enableEventValidation |
指定页和控件是否验证回发和回调事件。默认值为 True。 |
||||||||
|
enableSessionState |
可选的 String 属性。 为配置文件范围内的资源指定会话状态要求。 enableSessionState 属性可以为下列可能值之一。默认值为 True。
|
||||||||
|
enableViewState |
可选的 Boolean 属性。 指定视图状态是否启用并在多个页请求之间保持。 默认值为 True。 |
||||||||
|
enableViewStateMac |
可选的 Boolean 属性。 指定从客户端回发页时，ASP.NET 是否应该对页的视图状态运行消息身份验证代码 (MAC)。如果为 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 属性重写配置文件中设置的该属性。 此属性可以为下列可能值之一。
此属性是 .NET Framework 2.0 中的新属性。 默认值为 Auto。 |
| 元素 | 说明 |
|---|---|
|
controls |
定义标记前缀所在的 register 指令和命名空间的集合。 |
|
namespaces |
定义一个将在程序集预编译期间使用的导入指令的集合。 |
|
tagMapping |
定义一个标记类型的集合，这些标记类型在编译时重新映射为其他标记类型。 |
| 元素 | 说明 |
|---|---|
|
configuration |
公共语言运行库和基于 .NET Framework 的应用程序使用的每个配置文件中都需要的根元素。 |
|
system.web |
指定配置文件中 ASP.NET 配置设置的根元素，并且包含各种配置元素，这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。 |
以下几节描述了属性、子元素和父元素。
属性| 属性 | 说明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
|
asyncTimeout |
可选的 TimeSpan 属性。 指定在异步处理过程中等待异步处理程序完成的时间（以秒为单位）。 此属性是 .NET Framework 2.0 版中的新属性。 默认值为 "0:00:45"（45 秒）。 |
||||||||
|
autoEventWireup |
可选的 Boolean 属性。 指定是否自动启用页事件。当出现自动事件连接时就是如此，它表示系统将自动连接特定签名的方法（如 page_Load）。有关更多信息，请参见 ASP.NET Web 服务器控件事件模型。 默认值为 True。 |
||||||||
|
buffer |
可选的 Boolean 属性。 指定 URL 资源是否使用响应缓冲。 默认值为 True。 |
||||||||
|
compilationMode |
可选的 CompilationMode 属性。 指定是否应当在运行时编译 ASP.NET 页或控件。 compilationMode 属性是 .NET Framework 2.0 中的新属性。此属性可以为下列可能值之一。默认值为 Always。
|
||||||||
|
enableEventValidation |
指定页和控件是否验证回发和回调事件。默认值为 True。 |
||||||||
|
enableSessionState |
可选的 String 属性。 为配置文件范围内的资源指定会话状态要求。 enableSessionState 属性可以为下列可能值之一。默认值为 True。
|
||||||||
|
enableViewState |
可选的 Boolean 属性。 指定视图状态是否启用并在多个页请求之间保持。 默认值为 True。 |
||||||||
|
enableViewStateMac |
可选的 Boolean 属性。 指定从客户端回发页时，ASP.NET 是否应该对页的视图状态运行消息身份验证代码 (MAC)。如果为 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 属性重写配置文件中设置的该属性。 此属性可以为下列可能值之一。
此属性是 .NET Framework 2.0 中的新属性。 默认值为 Auto。 |
| 元素 | 说明 |
|---|---|
|
controls |
定义标记前缀所在的 register 指令和命名空间的集合。 |
|
namespaces |
定义一个将在程序集预编译期间使用的导入指令的集合。 |
|
tagMapping |
定义一个标记类型的集合，这些标记类型在编译时重新映射为其他标记类型。 |
| 元素 | 说明 |
|---|---|
|
configuration |
公共语言运行库和基于 .NET Framework 的应用程序使用的每个配置文件中都需要的根元素。 |
|
system.web |
指定配置文件中 ASP.NET 配置设置的根元素，并且包含各种配置元素，这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。 |
备注
-
@ Page 指令 (@ Page)。
-
通过 namespaces 子元素使用 @ Import 指令 (@ Import)。
-
通过 controls 子元素使用的 @ Register 指令 (@ Register)。
pages 元素还为以下操作提供支持：在运行时通过 tagMapping 元素将标记类型映射到其他标记类型。
 注意 |
|---|
|
将 @ Page 指令添加到母版页时不能在依赖于母版页的页中使用相同的指令声明。而应该使用 pages 配置元素来全局定义页指令。 |
默认配置
下面的默认 pages 元素不是在 Machine.config 文件或根 Web.config 文件中显式配置的。但是，它是由应用程序返回的默认配置。命名空间和控件是在根 Web.config 文件中添加的。
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"
>
下面的代码示例演示如何指定多个页配置设置。
enableSessionState="true"
autoEventWireup="true"
maintainScrollPositionOnPostBack="true"
masterPageFile = "~/Masters/Page1.master" />
元素信息
|
配置节处理程序 |
|
|
配置成员 |
|
|
可配置的位置 |
Machine.config 根级别的 Web.config 应用程序级别的 Web.config 虚拟或物理目录级别的 Web.config |
|
要求 |
Microsoft Internet 信息服务 (IIS) 5.0、5.1 或 6.0 版 .NET Framework 版本 1.0、1.1 或 2.0 Microsoft Visual Studio 2003 或 Visual Studio 2005 |