Настроечные параметры ASP.NET

Сброс всех разделов

Для удаления всех разделов и групп разделов используйте элемент <clear>. Он удаляет все разделы, объявленные до него, и все разделы, объявленные в предыдущих настроечных файлах. Ниже приведен пример использования элемента <clear> в настроечных файлах.

Файл machine.config

<configuration>
  <configSections>
    <section name="httpRuntime" type=
      "System.Web.Configuration.HttpRuntimeConfigurationHandler,
      System.Web, Version=1.0.3300.0, Culture=neutral,
      PublicKeyToken=b03f5f7f11d50a3a" />
  </configSections>
</configuration>

Файл web.config

<configuration>
  <configSections>
    <clear />
  </configSections>
</configuration>

Раздел <httpRuntime> из более раннего настроечного файла теперь не будет доступен.

Хотя раздел <configSections> не часто используется при работе с ASP.NET, очень важно понимать его функцию в архитектуре конфигурации. В части III данный раздел рассмотрен более подробно с точки зрения создания своих собственных разделов и обработчиков разделов.

Работа с <appSettings>

Раздел <appSettings> позволяет хранить в настроечном файле символьные строки и получать эти значения из любого приложения. Эти строки, или значения, хранятся вместе с ключами, которые используются для получения строки в приложениях. Давайте посмотрим на различные элементы из раздела <appSettings>. В дальнейшем вы встретитесь с атрибутом file, который служит для указания файла XML, содержащего различные элементы <appSettings>.

Добавление значения

При наличии строки, к которой требуется доступ из разных файлов приложений, следует добавить ее в раздел <appSettings> своего настроечного файла. Если это значение должно быть доступно всем приложениям вашего сервера, его также можно добавить в файл machine.config. Для добавления значения в коллекцию <appSettings> служит элемент <add> – задайте ключ, идентифицирующий значение в вашей коллекции, и значение, которое вы хотите сохранить. Для добавления элемента <add> используйте следующий синтаксис.

<appSettings>
  <add key="ourKey" value="ourValue" />
</appSettings>

Атрибуты элемента <add> перечислены в таблице 3.4.

Данный пример демонстрирует, как добавлять в настроечный файл строку базы данных.

<appSettings>
  <add key="ConnString" value="server=192.168.0.12;database=mydb;
    UID=myuser;Password=mypassword" />
</appSettings>

Здесь в коллекцию добавлена пара ключ/значение. Ключ называется ConnString, а значением пары является строка соединения с сервером. В конце этого раздела вы увидите, как получить доступ к этому значению при помощи ASP.NET.

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

Удаление значения

Тег <remove> используется для удаления из коллекции пары ключ/значение. Вы указываете ключ пары, которую нужно удалить, и указанная пара в этой коллекции становится недоступной. Это полезно, если необходимо удалить параметр, который был добавлен в коллекцию на более высоком уровне. Например, пара ключ/значение, добавленная в файл machine.config, может быть изъята на уровне файла web.config с помощью следующей записи.

<appSettings>
  <remove key="ourKey" />
</appSettings>

В таблице 3.5 показаны значения атрибута элемента <remove>.

Следующий пример показывает, как удалить строку, добавленную в предыдущем разделе.

<appSettings>
  <remove key="ConnString" />
</appSettings>

Данная пара ключ/значение будет недоступна этому приложению и любым другим приложениям, наследующим этот файл web.config.

Сброс всех значений

Элемент <clear> используется для полного сброса коллекции <appSettings>. Аналогично элементу <remove>, он служит для удаления различных пар ключ/значение, но при этом удаляет все пары. Ниже приведен пример элемента <clear>.

<appSettings>
  <clear/>
</appSettings>

Добавление этого элемента в раздел <appSettings> полностью очищает его.