原始 KB 编号: 815178

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

将配置设置添加到Web.config

大多数 ASP.NET 应用程序都附带一个预生成 Web.config 文件,该文件可以使用任何文本编辑器(如记事本)进行编辑。 通常, Web.config 文件包含批注,使编辑文件变得不言自明。 但是,可能必须将配置项添加到尚未定义配置项 的Web.config 文件。 若要将标准配置项添加到 Web.config 文件,请执行以下步骤:

  • 在文本编辑器(如记事本)中打开 Machine.config 文件。

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

  • 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"
  • 将整个配置元素和任何开始注释复制到剪贴板。

  • 确定元素如何嵌套在 Machine.config 文件中。

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

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

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

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

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

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

  • 修改 Web.config 文件中的配置元素以替代 该应用程序的Machine.config 设置。

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

  • 如何为 ASP.NET 应用程序创建Web.config文件

  • 如何部署基于.NET Framework构建的应用程序

  • ASP.NET 配置

  • ASP.NET 配置文件的格式

  •