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


<Элемент 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 файлах, которые не находятся на уровне каталога приложения.

См. также раздел