热门标签 | 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



推荐阅读
  • Spring Boot 中配置全局文件上传路径并实现文件上传功能
    本文介绍如何在 Spring Boot 项目中配置全局文件上传路径,并通过读取配置项实现文件上传功能。通过这种方式,可以更好地管理和维护文件路径。 ... [详细]
  • 在JavaWeb开发中,文件上传是一个常见的需求。无论是通过表单还是其他方式上传文件,都必须使用POST请求。前端部分通常采用HTML表单来实现文件选择和提交功能。后端则利用Apache Commons FileUpload库来处理上传的文件,该库提供了强大的文件解析和存储能力,能够高效地处理各种文件类型。此外,为了提高系统的安全性和稳定性,还需要对上传文件的大小、格式等进行严格的校验和限制。 ... [详细]
  • DVWA学习笔记系列:深入理解CSRF攻击机制
    DVWA学习笔记系列:深入理解CSRF攻击机制 ... [详细]
  • 优化后的标题:深入探讨网关安全:将微服务升级为OAuth2资源服务器的最佳实践
    本文深入探讨了如何将微服务升级为OAuth2资源服务器,以订单服务为例,详细介绍了在POM文件中添加 `spring-cloud-starter-oauth2` 依赖,并配置Spring Security以实现对微服务的保护。通过这一过程,不仅增强了系统的安全性,还提高了资源访问的可控性和灵活性。文章还讨论了最佳实践,包括如何配置OAuth2客户端和资源服务器,以及如何处理常见的安全问题和错误。 ... [详细]
  • 本文将带你快速了解 SpringMVC 框架的基本使用方法,通过实现一个简单的 Controller 并在浏览器中访问,展示 SpringMVC 的强大与简便。 ... [详细]
  • PTArchiver工作原理详解与应用分析
    PTArchiver工作原理及其应用分析本文详细解析了PTArchiver的工作机制,探讨了其在数据归档和管理中的应用。PTArchiver通过高效的压缩算法和灵活的存储策略,实现了对大规模数据的高效管理和长期保存。文章还介绍了其在企业级数据备份、历史数据迁移等场景中的实际应用案例,为用户提供了实用的操作建议和技术支持。 ... [详细]
  • 如何使用 `org.apache.tomcat.websocket.server.WsServerContainer.findMapping()` 方法及其代码示例解析 ... [详细]
  • Java Socket 关键参数详解与优化建议
    Java Socket 的 API 虽然被广泛使用,但其关键参数的用途却鲜为人知。本文详细解析了 Java Socket 中的重要参数,如 backlog 参数,它用于控制服务器等待连接请求的队列长度。此外,还探讨了其他参数如 SO_TIMEOUT、SO_REUSEADDR 等的配置方法及其对性能的影响,并提供了优化建议,帮助开发者提升网络通信的稳定性和效率。 ... [详细]
  • Spring框架中枚举参数的正确使用方法与技巧
    本文详细阐述了在Spring Boot框架中正确使用枚举参数的方法与技巧,旨在帮助开发者更高效地掌握和应用枚举类型的数据传递,适合对Spring Boot感兴趣的读者深入学习。 ... [详细]
  • 本文介绍了如何利用Struts1框架构建一个简易的四则运算计算器。通过采用DispatchAction来处理不同类型的计算请求,并使用动态Form来优化开发流程,确保代码的简洁性和可维护性。同时,系统提供了用户友好的错误提示,以增强用户体验。 ... [详细]
  • 本指南介绍了如何在ASP.NET Web应用程序中利用C#和JavaScript实现基于指纹识别的登录系统。通过集成指纹识别技术,用户无需输入传统的登录ID即可完成身份验证,从而提升用户体验和安全性。我们将详细探讨如何配置和部署这一功能,确保系统的稳定性和可靠性。 ... [详细]
  • Keepalived 提供了多种强大且灵活的后端健康检查机制,包括 HTTP_GET、SSL_GET、TCP_CHECK、SMTP_CHECK 和 MISC_CHECK 等多种检测方法。这些健康检查功能确保了高可用性环境中的服务稳定性和可靠性。通过合理配置这些检查方式,可以有效监测后端服务器的状态,及时发现并处理故障,从而提高系统的整体性能和可用性。 ... [详细]
  • 深入探索HTTP协议的学习与实践
    在初次访问某个网站时,由于本地没有缓存,服务器会返回一个200状态码的响应,并在响应头中设置Etag和Last-Modified等缓存控制字段。这些字段用于后续请求时验证资源是否已更新,从而提高页面加载速度和减少带宽消耗。本文将深入探讨HTTP缓存机制及其在实际应用中的优化策略,帮助读者更好地理解和运用HTTP协议。 ... [详细]
  • 在iOS开发中,基于HTTPS协议的安全网络请求实现至关重要。HTTPS(全称:HyperText Transfer Protocol over Secure Socket Layer)是一种旨在提供安全通信的HTTP扩展,通过SSL/TLS加密技术确保数据传输的安全性和隐私性。本文将详细介绍如何在iOS应用中实现安全的HTTPS网络请求,包括证书验证、SSL握手过程以及常见安全问题的解决方法。 ... [详细]
  • 本文以 www.域名.com 为例,详细介绍如何为每个注册用户提供独立的二级域名,如 abc.域名.com。实现这一功能的核心步骤包括:首先,确保域名支持泛解析,即将 A 记录设置为 *.域名.com,以便将所有二级域名请求指向同一服务器。接着,在服务器端使用 ASP.NET 2.0 进行配置,通过解析 HTTP 请求中的主机头信息,动态识别并处理不同的二级域名,从而实现个性化内容展示。此外,还需在数据库中维护用户与二级域名的对应关系,确保每个用户的二级域名都能正确映射到其专属内容。 ... [详细]
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社区 版权所有