热门标签 | HotTags
当前位置:  开发笔记 > 编程语言 > 正文

pages元素(ASP.NET设置架构)web.config详解

pages元素(ASP.NET设置架构)buffer[True|False]enableEventValidation[True|False]e
pages 元素(ASP.NET 设置架构)
   buffer="[True|False]"
   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。

说明

Always

应始终编译该页。

Auto

ASP.NET 将尽可能不编译该页。

Never

应当从不动态编译该页或控件。

如果某页包含需要编译的脚本块或代码构造,ASP.NET 将因为出错而返回,并且该页将不会运行。

enableEventValidation

指定页和控件是否验证回发和回调事件。默认值为 True。

enableSessionState

可选的 String 属性。

为配置文件范围内的资源指定会话状态要求。

enableSessionState 属性可以为下列可能值之一。默认值为 True。

说明

False

指示会话状态已禁用。

ReadOnly

表明会话状态不可写。

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 属性重写配置文件中设置的该属性。

此属性可以为下列可能值之一。

说明

Always

视图状态始终加密。

Auto

视图状态根据控件的请求而加密。

Never

视图状态从不加密,即使控件请求加密时也是如此。

此属性是 .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。

说明

Always

应始终编译该页。

Auto

ASP.NET 将尽可能不编译该页。

Never

应当从不动态编译该页或控件。

如果某页包含需要编译的脚本块或代码构造,ASP.NET 将因为出错而返回,并且该页将不会运行。

enableEventValidation

指定页和控件是否验证回发和回调事件。默认值为 True。

enableSessionState

可选的 String 属性。

为配置文件范围内的资源指定会话状态要求。

enableSessionState 属性可以为下列可能值之一。默认值为 True。

说明

False

指示会话状态已禁用。

ReadOnly

表明会话状态不可写。

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 属性重写配置文件中设置的该属性。

此属性可以为下列可能值之一。

说明

Always

视图状态始终加密。

Auto

视图状态根据控件的请求而加密。

Never

视图状态从不加密,即使控件请求加密时也是如此。

此属性是 .NET Framework 2.0 中的新属性。

默认值为 Auto。

子元素
元素说明

controls

定义标记前缀所在的 register 指令和命名空间的集合。

namespaces

定义一个将在程序集预编译期间使用的导入指令的集合。

tagMapping

定义一个标记类型的集合,这些标记类型在编译时重新映射为其他标记类型。

父元素
元素说明

configuration

公共语言运行库和基于 .NET Framework 的应用程序使用的每个配置文件中都需要的根元素。

system.web

指定配置文件中 ASP.NET 配置设置的根元素,并且包含各种配置元素,这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。

以下内容为程序代码:
备注
pages 元素定义页特定的配置设置。此配置节支持如下操作:在全局范围内为配置文件范围内的所有页和控件设置某些 ASP.NET 页和控件指令。这包括以下页级别的指令,这些指令所指定的设置由页和用户控件编译器在处理 ASP.NET Web 窗体页 (.aspx) 和用户控件 (.ascx) 文件时使用:
  • @ 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" />
  

元素信息

配置节处理程序

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



推荐阅读
  • 这是原文链接:sendingformdata许多情况下,我们使用表单发送数据到服务器。服务器处理数据并返回响应给用户。这看起来很简单,但是 ... [详细]
  • HDU 2372 El Dorado(DP)的最长上升子序列长度求解方法
    本文介绍了解决HDU 2372 El Dorado问题的一种动态规划方法,通过循环k的方式求解最长上升子序列的长度。具体实现过程包括初始化dp数组、读取数列、计算最长上升子序列长度等步骤。 ... [详细]
  • 本文介绍了OC学习笔记中的@property和@synthesize,包括属性的定义和合成的使用方法。通过示例代码详细讲解了@property和@synthesize的作用和用法。 ... [详细]
  • [译]技术公司十年经验的职场生涯回顾
    本文是一位在技术公司工作十年的职场人士对自己职业生涯的总结回顾。她的职业规划与众不同,令人深思又有趣。其中涉及到的内容有机器学习、创新创业以及引用了女性主义者在TED演讲中的部分讲义。文章表达了对职业生涯的愿望和希望,认为人类有能力不断改善自己。 ... [详细]
  • 本文介绍了高校天文共享平台的开发过程中的思考和规划。该平台旨在为高校学生提供天象预报、科普知识、观测活动、图片分享等功能。文章分析了项目的技术栈选择、网站前端布局、业务流程、数据库结构等方面,并总结了项目存在的问题,如前后端未分离、代码混乱等。作者表示希望通过记录和规划,能够理清思路,进一步完善该平台。 ... [详细]
  • 本文介绍了Web学习历程记录中关于Tomcat的基本概念和配置。首先解释了Web静态Web资源和动态Web资源的概念,以及C/S架构和B/S架构的区别。然后介绍了常见的Web服务器,包括Weblogic、WebSphere和Tomcat。接着详细讲解了Tomcat的虚拟主机、web应用和虚拟路径映射的概念和配置过程。最后简要介绍了http协议的作用。本文内容详实,适合初学者了解Tomcat的基础知识。 ... [详细]
  • 本文介绍了通过ABAP开发往外网发邮件的需求,并提供了配置和代码整理的资料。其中包括了配置SAP邮件服务器的步骤和ABAP写发送邮件代码的过程。通过RZ10配置参数和icm/server_port_1的设定,可以实现向Sap User和外部邮件发送邮件的功能。希望对需要的开发人员有帮助。摘要长度:184字。 ... [详细]
  • 在重复造轮子的情况下用ProxyServlet反向代理来减少工作量
    像不少公司内部不同团队都会自己研发自己工具产品,当各个产品逐渐成熟,到达了一定的发展瓶颈,同时每个产品都有着自己的入口,用户 ... [详细]
  • 猜字母游戏
    猜字母游戏猜字母游戏——设计数据结构猜字母游戏——设计程序结构猜字母游戏——实现字母生成方法猜字母游戏——实现字母检测方法猜字母游戏——实现主方法1猜字母游戏——设计数据结构1.1 ... [详细]
  • ASP.NET2.0数据教程之十四:使用FormView的模板
    本文介绍了在ASP.NET 2.0中使用FormView控件来实现自定义的显示外观,与GridView和DetailsView不同,FormView使用模板来呈现,可以实现不规则的外观呈现。同时还介绍了TemplateField的用法和FormView与DetailsView的区别。 ... [详细]
  • CentOS 7部署KVM虚拟化环境之一架构介绍
    本文介绍了CentOS 7部署KVM虚拟化环境的架构,详细解释了虚拟化技术的概念和原理,包括全虚拟化和半虚拟化。同时介绍了虚拟机的概念和虚拟化软件的作用。 ... [详细]
  • ScrollView嵌套Collectionview无痕衔接四向滚动,支持自定义TitleView
    本文介绍了如何实现ScrollView嵌套Collectionview无痕衔接四向滚动,并支持自定义TitleView。通过使用MainScrollView作为最底层,headView作为上部分,TitleView作为中间部分,Collectionview作为下面部分,实现了滚动效果。同时还介绍了使用runtime拦截_notifyDidScroll方法来实现滚动代理的方法。具体实现代码可以在github地址中找到。 ... [详细]
  • 禁止程序接收鼠标事件的工具_VNC Viewer for Mac(远程桌面工具)免费版
    VNCViewerforMac是一款运行在Mac平台上的远程桌面工具,vncviewermac版可以帮助您使用Mac的键盘和鼠标来控制远程计算机,操作简 ... [详细]
  • C# 7.0 新特性:基于Tuple的“多”返回值方法
    本文介绍了C# 7.0中基于Tuple的“多”返回值方法的使用。通过对C# 6.0及更早版本的做法进行回顾,提出了问题:如何使一个方法可返回多个返回值。然后详细介绍了C# 7.0中使用Tuple的写法,并给出了示例代码。最后,总结了该新特性的优点。 ... [详细]
  • 预备知识可参考我整理的博客Windows编程之线程:https:www.cnblogs.comZhuSenlinp16662075.htmlWindows编程之线程同步:https ... [详细]
author-avatar
书友60614683
这个家伙很懒,什么也没留下!
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有