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

Во второй части описываются все настроечные параметры ASP.NET, используемые для настройки приложений. Лекция 3 посвящена первым двум разделам настроечных файлов: разделам <configSections> и <appSettings>. "Лекция 4" описывает разделы и параметры, непосредственно связанные с ASP.NET, включая разделы и параметры из группы разделов System.Web. "Лекция 5" описывает разделы и параметры, относящиеся к Microsoft Mobile Internet Toolkit, "лекция 6" – параметры для остальных пространств имен Microsoft .NET Framework, "лекция 7" – параметры Common Language Runtime. В "лекции 8" рассказывается о параметрах, используемых при работе с инструментом администрирования IIS.

Раздел настроек и параметры приложений

В "лекции 1" вы уже видели раздел <configSections>, а здесь он описан более подробно. Также приведено описание раздела <appSettings>, используемого для добавления в настроечный файл дополнительных параметров и последующего доступа к этим параметрам из ваших приложений. Вы познакомитесь с разделами, параметрами и значениями для каждого раздела, узнаете, как использовать эти параметры на самых распространенных примерах. В данной лекции охвачены следующие вопросы.

• <configSections>. Раздел содержит все объявления обработчиков разделов настроек (о них уже говорилось раньше), но теперь мы познакомимся с различными элементами, которые можно использовать в этом разделе.
• <appSettings>. Раздел позволяет централизованно хранить различные параметры, а также используется для хранения и возврата строк пары ключ/значение. Вы узнаете, как хранить эти значения и как использовать их в приложении.

Работа с <configSections>

Раздел <configSections> содержит все объявления обработчиков разделов настроек. Обработчики разделов настроек – это классы .NET, которые интерпретируют параметры и значения, содержащиеся в разделах настроек. В разделе <configSections> можно объявить новый раздел, удалить раздел и даже все объявления разделов.

Объявление раздела

Первым элементом в разделе <configSections> является <section>. Этот элемент используется для объявления раздела настроек, используемого далее в настроечном файле. Ниже приведен синтаксис элемента <section>.

<section name="SectionName" type="ConfigurationHandler"
  allowLocation="true | false"
  allowDefinition="Everywhere | MachineOnly | MachineToApplication" />

Таблица 3.1 содержит список атрибутов элемента <section>.

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

<section name="runtime" type="System.Configuration.
  IgnoreSectionHandler, System, Version=1.0.330.0, Culture=neutral,
  PublicKeyToken=b77a5c561934e089" allowLocation="false" />

Здесь вы видите объявление раздела с именем runtime. Имя раздела, равное значению runtime, указано с помощью атрибута name. Атрибут type указывает на обработчик раздела настроек, который будет интерпретировать раздел, – System.Configuration.IgnoreSectionHandler.

Объявление группы разделов

Элемент <sectionGroup> объявляет группу разделов и объявления всех включенных в него разделов. Группа разделов – это логическое объединение нескольких разделов. В настроечных файлах каждое настраиваемое пространство имен будет иметь свою собственную группу разделов. Обычно файл machine.config содержит различные группы разделов, включая System.Web и System.Net. Если вы хотите включить для своего пространства имен несколько разделов настроек, то их нужно поместить в группу разделов. Ниже приведен синтаксис для объявления группы разделов.

<sectionGroup name="section group name" >
  <!-- Section declarations here -->
</sectionGroup>

В таблице 3.2 приведены значения атрибутов элемента <sectionGroup>.

Следующий пример объявляет группу разделов System.Web и включает объявление раздела <httpRuntime>.

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

Далее в настроечном файле вы включите этот раздел в <sectionGroup>.

<system.web>
  <httpRuntime executionTimeout="5000" maxRequestLength="4096"
    useFullyQualifiedRedirectUrl="false" minFreeThreads="8"
    minLocalRequestFreeThreads="4" appRequestQueueLimit="100" />
</system.web>

Удаление раздела

Для удаления из вашего настроечного файла разделов или групп разделов используется элемент <remove>. Ниже приведен его синтаксис.

<remove name="section or section group name" />

В таблице 3.3 приведены значения атрибута элемента <remove>.

Ниже показано, как нужно удалять объявление раздела, который наследуется из предыдущего настроечного файла.

<configSections>
  <remove name="httpRuntime" />
</configSections>

В примере удаляется раздел <httpRuntime> из группы <configSections>, что запретит настройку параметров httpRuntime в данном настроечном файле и всех настроечных файлах, наследуемых от него.