appSettings 的 add 元素（常规设置架构）
[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
向应用程序设置集合添加名称/值对形式的自定义应用程序设置。
<add
key="String name"
value="String value"
/>
特性和元素
以下几节描述了特性、子元素和父元素。
特性
特性 |
说明 |
|---|---|
key |
必选的 String 特性。 指定应用程序设置的名称。 此特性是集合键。 |
value |
必选的 String 特性。 指定应用程序设置的值。 |
继承的特性 |
可选特性。 由所有节元素继承的特性。 有关更多信息，请参见 节元素所继承的常规特性。 |
子元素
无。
父元素
元素 |
说明 |
|---|---|
configuration |
指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
指定配置文件中 ASP.NET 配置设置的根元素，并包含用于配置 ASP.NET Web 应用程序和控制应用程序行为方式的配置元素。 |
appSettings |
包含自定义应用程序设置，如文件路径、XML Web services URL 或存储在应用程序的 .ini 文件中的任何信息。 |
备注
add 元素向 appSettings 元素中的继承应用程序设置集合添加名称/值对形式的自定义应用程序设置。
重要
密匙必须唯一。如果您添加具有相同键的多个项，则仅保留最后一项。
appSettings 元素存储自定义应用程序配置信息，如文件路径、XML Web services URL 或存储在应用程序的 .ini 文件中的任何信息。 可以使用 ConfigurationSettings 类在代码中访问 appSettings 元素中指定的键/值对。 类的示例演示了如何以编程方式访问 appSettings。
默认配置
下面的默认 appSettings 元素在 .NET Framework 版本 1.0 和 1.1 的 Machine.config 文件中配置。
<appSettings>
<add key="XML File Name" value="myXmlFileName.xml" />
</appSettings>
示例
在 file 特性中指定的配置文件必须将 appSettings（而不是 configuration）作为根节点。 下面的代码对于 file 特性指定的配置文件是正确的。
<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="Application1" value="MyApplication1" />
<add key="Setting1" value="MySetting" />
</appSettings>
下面的代码示例演示如何在配置文件中定义自定义应用程序设置。
<configuration>
<appSettings>
<add key="Application Name" value="MyApplication" />
</appSettings>
</configuration>
元素信息
配置节处理程序 |
|
配置成员 |
|
可配置的位置 |
Machine.config 根级别的 Web.config 应用程序级别的 Web.config 虚拟或物理目录级别的 Web.config |
要求 |
Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0 .NET Framework 版本 1.0、1.1 或 2.0 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
请参见
参考
appSettings 的 clear 元素（常规设置架构）
appSettings 的 remove 元素（常规设置架构）