Элемент add для элемента appSettings (схема общих параметров)

Статья
08/11/2011

Добавляет в коллекцию параметров приложения пользовательский параметр приложения в виде пары имя-значение.

<add
   key="String name"
   value="String value"
/>

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут	Описание
key	Обязательный атрибут элемента String. Задает имя параметра приложения. Этот атрибут является ключом коллекции.
value	Обязательный атрибут типа String. Задает значение параметра приложения.
Наследуемые атрибуты	Необязательные атрибуты. Атрибуты, наследуемые всеми элементами раздела. Дополнительные сведения см. в разделе Общие атрибуты, наследуемые элементами раздела.

key

Обязательный атрибут элемента String.

Задает имя параметра приложения. Этот атрибут является ключом коллекции.

value

Обязательный атрибут типа String.

Задает значение параметра приложения.

Наследуемые атрибуты

Необязательные атрибуты.

Атрибуты, наследуемые всеми элементами раздела. Дополнительные сведения см. в разделе Общие атрибуты, наследуемые элементами раздела.

Дочерние элементы

Отсутствует.

Родительские элементы

Элемент	Описание
configuration	Задает обязательный корневой элемент любого файла конфигурации, который используется средой CLR и приложениями .NET Framework.
system.web	Задает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации и содержит элементы конфигурации для настройки веб-приложений ASP.NET и управления поведением этих приложений.
appSettings	Содержит пользовательские параметры приложения, такие как пути к файлам, URL-адреса веб-служб XML и другие сведения, хранящиеся в INI-файле приложения.

Заметки

Элемент add добавляет пользовательский параметр приложения в виде пары имя-значение в коллекцию наследуемых параметров приложения в элементе appSettings.

Важно
Ключи должны быть уникальными.Если добавить несколько записей с одинаковыми ключом, сохраняется только последняя запись.

В элементе appSettings хранятся данные пользовательской конфигурации, такие как пути к файлам, URL-адреса веб-служб XML и другие сведения, хранящиеся в INI-файле приложения. Доступ к парам ключ-значение, заданным в элементе appSettings, можно получить из кода с помощью класса ConfigurationSettings. Следующий пример класса иллюстрирует программный вызов appSettings.

Параметры по умолчанию

Для .NET Framework версий 1.0 и 1.1 следующий элемент appSettings по умолчанию настраивается в файле 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>

Сведения об элементе

Обработчик раздела конфигурации	AppSettingsSection
Член конфигурации	Add
Настраиваемые расположения	Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения Файл Web.config уровня виртуального или физического каталога
Требования	Microsoft IIS версии 5.0, 5.1 или 6.0 .NET Framework версии 1.0, 1.1 или 2.0 Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Поделиться через