<appSettings> 配置 <元素>

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

<配置>
   <appSettings>

Syntax

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

Attribute

Description
file 可选属性。

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

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

如果找不到指定的文件,运行时将忽略该属性。

Parent 元素

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

子元素

Description
<加> 添加自定义应用程序设置。
<清楚> 清除以前定义的所有应用程序设置。
<删除> 删除以前定义的应用程序设置。

注解

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

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

特性 file 指定的配置文件必须具有根节点而不是 <appSettings><configuration>

Example

以下示例显示了定义自定义应用程序设置的外部应用程序设置文件(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 文件。

另请参阅