<Элемент appSettings> для <конфигурации>
Содержит пользовательские параметры приложения. Это предопределенный раздел конфигурации, предоставляемый платформа .NET Framework.
<Конфигурации>
<appSettings>
Синтаксис
<appSettings>
<!-- Elements to add, clear, or remove configuration settings -->
</appSettings>
attribute
| Описание | |
|---|---|
| file | Необязательный атрибут. Указывает относительный путь к внешнему файлу, который содержит параметры пользовательской конфигурации приложения. Указанный файл содержит те же параметры, которые указаны в <элементах добавления>, <удаления> и <очистки> , и использует тот же формат пар "ключ-значение", что и эти элементы. Указанный путь относится к файлу конфигурации main. Для приложения Windows Forms это двоичная папка (например, /bin/debug), а не расположение файла конфигурации приложения. Для веб-формы приложений путь относится к корню приложения, где находится файлweb.config. Среда выполнения игнорирует атрибут , если не удается найти указанный файл. |
Родительский элемент
| Описание | |
|---|---|
| <Элемент configuration> | Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями .NET Framework. |
Дочерние элементы
| Описание | |
|---|---|
| <добавление> | Добавляет настраиваемый параметр приложения. |
| <Ясно> | Очищает все ранее определенные параметры приложения. |
| <Удалить> | Удаляет ранее определенный параметр приложения. |
Комментарии
Элемент <appSettings> хранит сведения о конфигурации пользовательского приложения, такие как строки подключения к базе данных, пути к файлам, URL-адреса веб-службы XML или любые другие пользовательские сведения о конфигурации для приложения. Пары "ключ-значение", указанные в элементе <appSettings> , доступны в коде ConfigurationSettings с помощью класса .
Атрибут file можно использовать в элементе <appSettings> файлов конфигурацииWeb.config и приложения. Этот атрибут задает файл конфигурации, который предоставляет дополнительные параметры или переопределяет параметры, указанные в элементе <appSettings> . Атрибут file можно использовать в сценариях разработки группы управления версиями, например, когда пользователь хочет переопределить параметры проекта, указанные в файле конфигурации приложения.
Файлы конфигурации, указанные атрибутом file , должны иметь корневой <узел appSettings> , а не <конфигурацию>.
Пример
В приведенном ниже примере показан внешний файл параметров приложения (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 файлах, которые не находятся на уровне каталога приложения.
