通过

编辑 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 文件时，必须在从中复制的同一元素中嵌套该配置元素。 若要确定 Configuration 元素包含的 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 文件和所有子文件夹的文件夹。

参考