ASP.NET 设置架构参考

ASP.NET 配置节架构包含用于控制 ASP.NET Web 应用程序运行方式的元素。其中指定了属性的默认值,在位于 systemroot\Microsoft.NET\Framework\versionNumber\Config\Machine.config 目录的 Machine.config 文件中设置。

下表列出了包含在 Web.config 文件中的所有元素,按照元素应该出现的顺序以及元素之间的嵌套关系来显示。

配置结构的示例:

<configuration>
   <location>
      <system.web>
         <authentication>
            <forms>
               <credentials>
            <passport>
         <authorization>
            <allow>
            <deny>
         <browserCaps>
            <result>
            <use>
            <filter>
               <case>
         <clientTarget>
            <add>
            <remove>
            <clear>
         <compilation>
            <compilers>
               <compiler>
            <assemblies>
               <add>
               <remove>
               <clear>
         <customErrors>
            <error>
         <globalization>
         <httpHandlers>
            <add>
            <remove>
            <clear>
         <httpModules>
            <add>
            <remove>
            <clear>
         <httpRuntime>
         <identity>
         <machineKey>
         <pages>
         <processModel>
         <securityPolicy>
            <trustLevel>
         <sessionState>
         <trace>
         <trust>
         <webServices>
            <protocols>
               <add>
               <remove>
               <clear>
            <serviceDescriptionFormatExtensionTypes>
               <add>
               <remove>
               <clear>
            <soapExtensionTypes>
               <add>
               <clear>
            <soapExtensionReflectorTypes>
               <add>
                <clear>
            <soapExtensionImporterTypes>
               <add>
               <clear> Element
            <WsdlHelpGenerator>
         </webServices>
      </system.web>
   </location>
</configuration>

下表提供了包含在 Web.config 文件中所有元素的简要描述。

元素 描述
<system.web> 为 ASP.NET 配置节指定根元素。
<assemblies> 的 <add> 元素 添加要在编译动态资源过程中使用的程序集引用。
<clientTarget> 的 <add> 元素 将特定用户代理的别名添加到内部用户代理别名集。
<httpHandlers> 的 <add> 元素 添加要在编译动态资源过程中使用的程序集的引用。
<httpModules> 的 <add> 元素 添加要在编译动态资源过程中使用的程序集的引用。
<protocols> 的 <add> 元素 添加可由 .NET Framework 用来对从客户端浏览器发送的 HTTP 请求中的数据进行解密的传输协议。
<serviceDescriptionFormatExtensionTypes> 的 <add> 元素 添加要在配置文件范围内运行的服务说明格式的扩展。
<soapExtensionTypes>、<soapExtensionImporterTypes> 和 <soapExtensionReflectorTypes> 的 <add> 元素 添加要在配置文件范围内与所有 XML Web 服务一起运行的 SOAP 扩展。
<allow> 允许访问资源。
<assemblies> 指定 ASP.NET 编译处理指令。
<authentication> 配置 ASP.NET 身份验证支持。
<authorization> 配置 ASP.NET 授权支持。
<browserCaps> 为浏览器功能组件配置设置。
<case> 允许在处理大量替换选项中的第一个成功匹配之后停止模式匹配。
<clear> 删除对适于父标记的项目的所有引用。
<clientTarget> 将特定用户代理的别名添加到内部用户代理别名集。
<compilation> 包含由 ASP.NET 使用的所有编译设置。
<compiler> 定义新的编译器选项。
<compilers> 指定 ASP.NET 应用程序所支持的编译器。
<credentials> 允许在配置文件中使用名称和密码凭据的可选定义。
<customErrors> 定义错误产生时用于 ASP.NET 应用程序的自定义的错误消息以及浏览器所重定向的页面。
<deny> 指定拒绝访问资源。
<error> 定义由自定义错误页面处理的自定义错误条件。
<filter> 允许按顺序应用多个规则。
<forms> 为自定义的基于窗体的身份验证配置 ASP.NET 应用程序。
<globalization> 配置应用程序的全局化设置。
<httpHandlers> 将传入的 URL 请求映射到 IHttpHandler 类。
<httpModules> 在应用程序中添加、删除或清除 HTTP 模块。
<httpRuntime> 配置 ASP.NET HTTP 运行时设置。本节可在计算机、站点、应用程序或子目录级别进行声明。
<identity> 用于控制 Web 应用程序的应用程序标识。
<location> 指定配置设置应用于其上的资源。
<machineKey> 配置用于对窗体身份验证 Cookie 数据进行加密和解密的密钥。本节允许开发人员配置验证密钥,以便针对视图状态数据和窗体身份验证票据执行消息身份验证检查。可以在计算机、站点或应用程序级别但却不能在子目录级别进行声明。
<pages> 标识网页特有的配置设置。
<passport> 指定在网页要求身份验证但用户未通过 Microsoft Passport 身份验证时所要重定向到的网页。
<processModel> 在 Internet 信息服务 (IIS) Web 服务器系统上配置 ASP.NET 进程模型设置。
<protocols> 指定可由 ASP.NET 用来对从客户端浏览器发送的 HTTP 请求中的数据进行解密的传输协议。
<assemblies> 的 <remove> 元素 删除对程序集的引用。
<clientTarget> 的 <remove> 元素 将特定用户代理的别名从内部用户代理别名集中删除。
<httpHandlers> 的 <remove> 元素 删除到 HttpHandler 类的一个动作/路径映射。
<httpModules> 的 <remove> 元素 删除对 HttpModule 类的引用。<remove> 的值必须与前面的 <add> 指令的值完全匹配。
<protocols> 的 <remove> 元素 从特定应用程序的受支持的 HTML 编码协议列表中删除单个协议。
<serviceDescriptionFormatExtensionTypes> 的 <remove> 元素 从配置文件范围中删除单个服务说明格式扩展类型。
<result> 用于防止分析本节结果(项 - 值字符串对)的 HttpCapabilitiesBase 派生类。该字符串用以在运行时创建返回类型。
<securityPolicy> 定义从命名安全级别到策略文件的有效映射。本节可在计算机、站点或应用程序级别进行声明。
<serviceDescriptionFormatExtensionTypes> 指定要在配置文件范围内运行的服务说明格式扩展。
<sessionState> 为当前的应用程序配置某些会话状态设置。
<soapExtensionImporterTypes> 指定当访问配置文件范围内的 XML Web 服务的服务说明时所要运行的 SOAP 扩展。
<soapExtensionReflectorTypes> 指定为配置文件范围内的所有 XML Web 服务生成服务说明时所要运行的 SOAP 扩展。
<soapExtensionTypes> 指定与配置文件范围内的所有 XML Web 服务一起运行的 SOAP 扩展。
<trace> 配置 ASP.NET 跟踪服务。
<trust> 配置用于运行特定应用程序的代码访问安全权限集。本节可在计算机、站点和应用程序级别进行声明。
<trustLevel> 定义从特定安全级别到命名策略文件的映射。
<use> 指定发送给该分析器的 HTTP 请求字符串。
<user> 允许在配置文件内定义用户名和密码凭据。
<webServices> 用于控制使用 ASP.NET 创建的 XML Web 服务的设置。
<WsdlHelpGenerator> 指定用于 XML Web 服务的 .aspx 帮助页面。


相关主题


© 1997-2003 Microsoft Corporation。保留所有权利