<элемент section>

  • Статья

Содержит объявление раздела конфигурации.

<Конфигурации>
  <configSections>
    <Разделе>

<Конфигурации>
  <configSections>
    <sectionGroup>
      <Разделе>

Синтаксис

<section name="section name"
         type="configuration section handler class, assembly"
         allowDefinition="Everywhere|MachineOnly|MachineToApplication"
         allowLocation="true|false" />

Требуемые атрибуты

Описание
name Указывает имя раздела конфигурации.
type Указывает имя класса обработчика раздела конфигурации, который считывает раздел из файла конфигурации. Значение типа имеет синтаксис "полное имя раздела-обработчика-класса, simple-assembly-name". Простое имя сборки — это корневое имя файла без расширения файла.dll .

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

Следующие атрибуты применимы только для ASP.NET приложений. Система конфигурации игнорирует эти атрибуты для других типов приложений.

Описание
allowDefinition Указывает, в каком файле конфигурации можно использовать раздел. Используйте одно из следующих значений:

Везде
Позволяет использовать раздел в любом файле конфигурации. Это значение по умолчанию.
MachineOnly
Позволяет использовать раздел только в файле конфигурации компьютера (Machine.config).
MachineToApplication
Позволяет использовать раздел в файле конфигурации компьютера или файле конфигурации приложения.
allowLocation Определяет, можно ли использовать раздел в элементе <location> . Используйте одно из следующих значений:

true
Позволяет использовать раздел в элементе <location> . Это значение по умолчанию.
false
Не позволяет использовать раздел в элементе <location> .

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

Описание
<Элемент configSections> Содержит раздел конфигурации и объявления пространства имен.
<элемент sectionGroup> Определяет пространство имен для разделов конфигурации.

Примечание

Элемент <section> является дочерним элементом <либо configSections> , либо <sectionGroup> , но не обоими.

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

Нет

Remarks

Объявление раздела конфигурации по сути определяет новый элемент для файла конфигурации. Новый элемент содержит параметры, которые считывает обработчик раздела конфигурации (то есть класс, реализующий IConfigurationSectionHandler интерфейс). Атрибуты и дочерние элементы определенного раздела зависят от обработчика раздела, используемого для чтения параметров.

Объявление обработчика раздела конфигурации в файлеMachine.config позволяет использовать раздел конфигурации в любом файле конфигурации приложения на этом компьютере, если атрибут allowDefinition не указывает иное.

Пример

В следующем примере показано, как определить раздел конфигурации и параметры для этого раздела:

<configuration>
  <configSections>
    <section name="sampleSection"
             type="System.Configuration.SingleTagSectionHandler"
             allowLocation="false" />
  </configSections>
  <sampleSection setting1="Value1"
                 setting2="value two"
                 setting3="third value" />
</configuration>

Файл конфигурации

Этот элемент можно использовать в файле конфигурации приложения, файле конфигурации компьютера (Machine.config) и Web.config файлах, которые не находятся на уровне каталога приложения.

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