编辑 ASP.NET 应用程序的配置

  • 项目

本文介绍如何编辑 ASP.NET 应用程序的Web.config 文件。

原始产品版本： ASP.NET
原始 KB 编号： 815178

摘要

Web.config 文件定义 ASP.NET 应用程序的行为。 Microsoft .NET Framework（包括 ASP.NET）使用 XML 格式的 .config 文本文件来配置应用程序。 这与传统的注册表和元数据库配置机制背道而去。 目前没有 Microsoft 管理控制台 (MMC) 管理单元或其他 Microsoft 提供的管理工具用于创建和修改 .config 文件。

将配置设置添加到 Web.config

大多数 ASP.NET 应用程序都附带预生成的 Web.config 文件，该文件可使用记事本等任何文本编辑器进行编辑。 通常， Web.config 文件包含使编辑文件一目了然的注释。 但是，可能需要将配置项目添加到尚未定义配置项 的Web.config 文件。 若要将标准配置项添加到 Web.config 文件，请执行以下步骤：

  1. 在文本编辑器（如记事本）中打开 Machine.config 文件。

    Machine.config 文件位于 %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ 目录中。

  2. 在 Machine.config 文件中，在 Web.config 文件中找到要替代的配置设置。 当元素是多行时，元素以一 <element_name> 行开头，以 </element_name>结尾。 元素也可能是自闭合的，并且可能类似于 <element_name attribute1='option' attribute2='option' />。 空格将被忽略。 因此，元素可以跨多行。 元素前面可能有注释。 注释包含在标记内 <!-- and --> 。 下面的 <trace> 配置元素示例是自闭合元素的示例。 配置 <trace> 元素示例具有多个属性，跨多个行，并在开头有一个注释。

    <!--
trace Attributes:
    enabled="[true|false]" - Enable application tracing
    localOnly="[true|false]" - View trace results from localhost only
    pageOutput="[true|false]" - Display trace output on individual pages
    requestLimit="[number]" - Number of trace results available in trace.axd
    traceMode="[SortByTime|SortByCategory]" - Sorts trace result displays based on Time or Category
 -->
<trace
    enabled="false"
    localOnly="true"
    pageOutput="false"
    requestLimit="10"
    traceMode="SortByTime"
/>

  3. 将整个配置元素和任何开始注释复制到剪贴板。

  4. 确定元素在 Machine.config 文件中的嵌套方式。

    Machine.config 文件是分层的，配置元素嵌套在其他元素中。 将配置元素从 Machine.config 文件复制到 Web.config 文件时，必须将该配置元素嵌套在复制它的同一元素中。 若要确定包含配置元素 的Machine.config 文件的元素，请在 Machine.config 文件中向上滚动，直到找到打开的元素，而不是关闭。 包含元素易于识别，因为较高级别的元素的缩进较少。

    大多数 ASP.NET 配置项都包含在 元素中 <system.web> 。 元素 ( ) </system.web> 的末尾必须放在配置元素之后。

    注意

    配置元素中包含的元素。 必须将该元素粘贴到 Web.config 文件中的同一元素中。 配置元素可以嵌套在多个元素中。 必须在 Web.config 文件中创建所有更高级别的元素。

  5. 关闭 Machine.config 文件，然后使用文本编辑器在 ASP.NET 应用程序的根目录中打开Web.config文件。

  6. 在步骤 4 中标识的元素的开头和末尾之间粘贴配置元素。

    例如，如果配置项包含在 元素中 <system.web> ，则配置项目必须紧贴在元素的 <system.web> 开始行之后和结束行之前 </system.web> 。

  7. 修改 Web.config 文件中的配置元素，以覆盖该应用程序 的Machine.config 设置。

    此设置适用于包含 Web.config 文件和所有子文件夹的文件夹。

References