编辑 ASP.NET 配置文件

更新:2007 年 11 月

ASP.NET 配置数据存储在 XML 文本文件中,每一个 XML 文本文件都命名为 Web.config。Web.config 文件可以出现在 ASP.NET 应用程序的多个目录中。每个 Web.config 文件都将配置设置应用于自己的目录及其下的所有子目录。可以选择用子目录中的设置重写或修改父目录中指定的设置。ASP.NET 配置层次结构的根目录为 systemroot\Microsoft.NET\Framework\versionNumber\CONFIG\Web.config 文件,其中包括要应用于所有运行特定版本 Microsoft .NET Framework 的 ASP.NET 应用程序的设置。由于每个 ASP.NET 应用程序都从根 Web.config 文件继承默认配置设置,因此只需为重写默认设置的设置创建 Web.config 文件。

配置文件结构

每个配置文件都包含嵌套的 XML 标记和子标记,这些标记和子标记具有用来指定配置设置的属性。所有的配置信息都驻留在 <configuration> 和 </configuration> 根 XML 标记之间。这些标记之间的配置信息分为两个主区域:配置节处理程序声明区域和配置节设置区域。有关更多信息,请参见 ASP.NET 配置文件结构(节和节处理程序)

编辑配置设置

由于它们是 XML 纯文本文件,所以您可以按下列方式创建或编辑配置设置:

区分大小写

因为这些标记必须是格式良好的 XML,所以标记、子标记和属性是区分大小写的。标记名和属性名是 Camel 大小写形式的,这意味着标记名的第一个字符是小写的,后面的任何连接单词的第一个字母是大写的。大多数情况下,字符串属性值是 Pascal 大小写形式的,这意味着第一个字符是大写的,后面的任何连接单词的第一个字母也是大写的。true 和 false 例外,它们总是小写的。

自定义节

ASP.NET 配置基础结构不对基础结构支持的配置数据的类型作出任何假设。配置节处理程序类处理所有的 Web.config 数据。您可以使用与 .NET Framework 一起提供的预定义的配置节处理程序,也可以创建自己的处理程序来处理自定义配置数据。

有关创建自定义配置类型的更多信息,请参见如何:使用 ConfigurationSection 创建自定义配置节

编辑远程配置文件

ASP.NET 配置 API 允许应用程序修改远程计算机上的配置文件。具体来说,可以修改远程计算机上任何 Microsoft Internet 信息服务 (IIS) 应用程序或其子目录中的 Machine.config 或 Web.config 文件。如果 Web.config 文件不存在,则返回的配置数据完全由应用于指定路径的继承设置组成。如果应用程序请求更新这些返回的配置数据,则会创建一个新文件。有关更多信息,请参见编辑 ASP.NET 远程配置文件如何:远程访问和修改 ASP.NET 配置文件

配置更改导致应用程序域重新启动

对 Web.config 文件中的配置设置进行更改将间接导致应用程序域重新启动。此行为是设计使然。您可以选择使用 configSource 属性来引用更改时不会导致重新启动的外部配置文件。有关更多信息,请参见节元素所继承的常规属性中的 configSource。

当无权编辑某个配置文件的人试图更改该文件时,将不会导致应用程序域重新启动。

有关更多信息,请参见管理对配置设置的更改

请参见

任务

如何:远程访问和修改 ASP.NET 配置文件

如何:使用 ConfigurationSection 创建自定义配置节

概念

保证 ASP.NET 配置的安全

编辑 ASP.NET 远程配置文件

管理对配置设置的更改

参考

.NET Framework 工具

其他资源

管理 ASP.NET 网站

配置应用程序