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

  • 项目

本文介绍如何创建用于控制单个 ASP.NET 应用程序行为的 Web.config 文件。

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

摘要

Microsoft .NET Framework（特别是 ASP.NET）使用 XML 格式的 .config 文件来配置应用程序。 这种做法不同于传统的注册表和元数据库配置机制。 目前没有 Microsoft 管理控制台 (MMC) 管理单元或其他 Microsoft 提供的管理工具，可用于创建和修改 .config 文件。

.config 文件的层次结构

.NET Framework依赖于 .config 文件来定义配置选项。 .config 文件是基于文本的 XML 文件。 多个 .config 文件可以且通常存在于单个系统上。

Machine.config 文件中定义了.NET Framework的系统范围配置设置。 Machine.config 文件位于 %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ 文件夹中。 可以修改 包含在Machine.config 文件中的默认设置，以影响 Microsoft .NET 应用程序在整个系统上的行为。

如果在应用程序的根文件夹中创建Web.config文件，则可以更改单个应用程序的 ASP.NET 配置设置。 执行此操作时， Web.config 文件中的设置将覆盖 Machine.config 文件中的设置。

创建 Web.config 文件

可以使用记事本等文本编辑器创建 Web.config 文件。 必须在 ASP.NET 应用程序的根目录中创建名为 Web.config 的文本文件。 Web.config 文件必须是格式正确的 XML 文档，并且格式必须与该文件%SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config类似。

Web.config 文件必须仅包含替代 Machine.config 文件中设置的配置项目的条目。 Web.config 文件必须至少具有 <configuration> 元素和 <system.web> 元素。 这些元素将包含单个配置元素。

以下示例显示了一个最小 Web.config 文件：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.web>
    </system.web>
</configuration>

Web.config 文件的第一行将文档描述为 XML 格式，并指定字符编码类型。 对于所有 .config 文件，第一行必须相同。

后面的行标记 元素的 <configuration> 开头和结尾以及 <system.web>Web.config 文件的 元素。 这些行本身不执行任何操作。 但是，这些行提供了一个结构，允许你添加将来的配置设置。 在 和 </system.web> 行之间<system.web>添加大部分 ASP.NET 配置设置。 这些行标记 ASP.NET 配置设置的开始和结束。

References