以下几节描述了属性、子元素和父元素。
| 属性 | 说明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
|
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 应用程序并控制这些应用程序的行为方式。 |