<configuration> 的 <appSettings> 元素

包含自定义应用程序设置。 这是 .NET Framework 所提供预定义的配置部分。

configuration
  <appSettings>

语法

<appSettings>
  <!-- Elements to add, clear, or remove configuration settings -->
</appSettings>

属性

说明
文件 可选特性。

指定包含自定义应用程序配置设置的外部文件的相对路径。 指定的文件包含与 <add>、<remove> 和 <clear> 元素中指定的同一种类型的设置,并使用与这些元素相同的键/值对格式。

指定的路径是相对于主配置文件的路径。 对于 Windows 窗体应用程序,这是二进制文件夹(例如 /bin/debug),而不是应用程序配置文件的位置。 对于 Web Forms 应用程序,该路径相对于 web.config 文件所在的应用程序根目录。

如果无法找到指定的文件,则运行时将忽略该特性。

父元素

描述
<configuration> 元素 公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。

子元素

说明
<add> 添加自定义应用程序设置。
<clear> 清除以前定义的所有应用程序设置。
<remove> 删除以前定义的应用程序设置。

备注

<appSettings> 元素存储自定义应用程序配置信息,如数据库连接字符串、文件路径、XML Web service URL 或应用程序的任何其他自定义配置信息。 <appSettings> 元素中指定的键/值对可以在代码中使用 ConfigurationSettings 类进行访问。

可以在 Web.config 和应用程序配置文件的 <appSettings> 元素中使用 file 特性。 此特性指定一个配置文件,用于提供其他设置或替代在 <appSettings> 元素中指定的设置。 file 特性可用于源代码管理团队开发场景,例如用户要替代应用程序配置文件中指定的项目设置时就可以使用。

file 特性指定的配置文件必须有一个根节点为 <appSettings>,而不是 <configuration>。

示例

下面的示例演示外部应用程序设置文件 (custom.config),该文件定义自定义应用程序设置:

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
  <add key="MyCustomSetting" value="MyCustomSettingValue" />
</appSettings>

下面的示例演示使用外部设置文件中的设置并自行设置应用程序设置的应用程序配置文件:

<configuration>
  <appSettings file="custom.config">
    <add key="ApplicationName" value="MyApplication" />
  </appSettings>
</configuration>

配置文件

此元素可用于应用程序配置文件、计算机配置文件 (Machine.config) 和不在应用程序目录级别的 Web.config 文件。

请参阅