pages 元素（ASP.NET 设置架构）web.config 详解
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"
>
下面的代码示例演示如何指定多个页配置设置。
<pages buffer="true"
enableSessionState="true"
autoEventWireup="true"
maintainScrollPositionOnPostBack="true"
masterPageFile = "~/Masters/Page1.master" />
元素信息
|
配置节处理程序 |
PagesSection |
|
配置成员 |
Pages Page |
|
可配置的位置 |
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 |
pages 元素（ASP.NET 设置架构）web.config 详解相关推荐
- Web.config详解＋asp.net优化（1）
一.认识Web.config文件 Web.config 文件是一个xml文本文件,它用来储存 asp.NET Web 应用程序的配置信息(如最常用的设置asp.NET Web 应用程序的身份验证方式) ...
- Web.config详解＋asp.net优化
Web.config详解+asp.net优化(1) 一.认识Web.config文件 Web.config 文件是一个xml文本文件,它用来储存 asp.NET Web 应用程序的配置信息(如最常用的 ...
- (转)asp.net夜话之十一：web.config详解
在开发中经常会遇到这样的情况,在部署程序时为了保密起见并不将源代码随项目一同发布,而我们开发时的环境与部署环境可能不一致(比如数据库不一样),如果在代码中保存这些配置这些信息部署时需要到用户那里更改代 ...
- asp.net夜话之十一：web.config详解
在开发中经常会遇到这样的情况,在部署程序时为了保密起见并不将源代码随项目一同发布,而我们开发时的环境与部署环境可能不一致(比如数据库不一样),如果在代码中保存这些配置这些信息部署时需要到用户那里更改代 ...
- 转载的Web.config详解
转自http://blog.csdn.net/21aspnet/archive/2007/03/20/1535585.aspx (一).Web.Config是以XML文件规范存储,配置文件分为以下格式 ...
- Web.config详解
< DOCTYPE html PUBLIC -WCDTD XHTML StrictEN httpwwwworgTRxhtmlDTDxhtml-strictdtd> <?xml ver ...
- Asp.net中的web.config配置
Asp.net中的web.config配置 Asp.net中的web.config配置... 1 一. 配置文件保存位置... 2 二. 配置文件加载顺序... 2 三. 配置文件节点介绍... 3 ...
- Windows 网络服务架构系列课程详解（六） ---利用NLB群集实现WEB服务器的可靠性...
Windows 网络服务架构系列课程详解(六) -----利用NLB群集实现WEB服务器的可靠性 实验背景: 在大型网络环境中存在这样一种情景,公司内部的FTP服务器出现故障或脱机了,而且不能快速 ...
- Stuts的Web.xml 详解
1 定义头和根元素 部署描述符文件就像所有XML文件一样,必须以一个XML头开始.这个头声明可以使用的XML版本并给出文件的字符编码. DOCYTPE声明必须立即出现在此头之后.这个声明告诉服务器适用 ...
最新文章
- 腾讯发布95页重磅报告：全面预测中国互联网未来5年趋势
- 分享两篇Google Map API的介绍
- 黄聪：wordpress源码解析-目录结构-文件调用关系（转）
- C语言程序设计，第四版 ，谭浩强。绝对原版，最新的资料
- 时钟服务器地址_时钟同步 Chrony 教程
- Linux_Make(Makefile)
- java贪心算法几个经典例子_经典算法思想5——贪心（greedy algorithm）
- JAVA中的异常及两种异常处理的方法
- 小程序和android毕设,微信小程序毕设论文（完整）
- sca60c使用程序_使用PHP的SDO和SCA扩展
- 一款局域网的聊天工具
- premiere学习笔记01帧定格，时间码，透明视频，调整图层，转场及批量转场，插件安装，音频调整，关键帧，马赛克，蒙版，嵌套序列
- Java实现MySql分页查询
- WMB入门之十:Java Compute节点
- Python Turtle绘图[难度2星]：横切的橙子（配色优化——邻近色/反差色）
- Python：数据类型转换之将Scikit-learn的Bunch数据类型转换为Pandas的DataFrame类型案例及代码实现
- Android快速开发之appBase——(1).appBase介绍
- Perl的CPAN和CPANPLUS安装模块介绍
- 分享10个高质量的插画网站
- Leetcode 129求根节点到叶节点数字之和、104二叉树的最大深度、8字符串转换整数(atoi)、82删除排序链表中的重复元素II、204二分查找、94二叉树的中序遍历、144二叉树的前序遍历