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


Элемент configSections (схема общих параметров)

Задает раздел конфигурации и объявления пространств имен.

   <configSections>
      <section />
      <sectionGroup />
      <remove />
      <clear/>
   </configSections>

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Отсутствует.

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

Элемент

Описание

clear

Удаляет все ссылки на унаследованные разделы и группы разделов, допуская только те разделы и группы разделов, которые добавлены текущими элементами section и sectionGroup.

remove

Удаляет ссылку на унаследованный раздел и группу разделов.

section

Определяет связь между обработчиком раздела конфигурации и элементом конфигурации.

sectionGroup

Определяет связь между обработчиком раздела конфигурации и разделом конфигурации.

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

Элемент

Описание

configuration

Задает обязательный корневой элемент любого файла конфигурации, который используется средой CLR и приложениями .NET Framework.

Заметки

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

Каждый элемент section определяет раздел или элемент конфигурации и связанный производный класс ConfigurationSection, который обрабатывает раздел или элемент конфигурации. Элементы section могут быть логически сгруппированы в элементы sectionGroup, чтобы упорядочить элементы section и избежать конфликтов при именовании. Элементы section и sectionGroup находятся в элементе configSections.

Если элемент configSections присутствует в файле конфигурации, то configSections должен быть первым дочерним элементом элемента configuration.

Конфигурация по умолчанию

Разделы конфигурации для элементов конфигурации .NET определяются в файле Machine.config. Их слишком много, чтобы перечислить их все здесь. В приведенном ниже фрагменте файла Machine.config определяется обработчик раздела конфигурации для элемента authentication раздела system.web. Затем определяются параметры конфигурации для элемента authentication.

Если обработчик раздела конфигурации не связан с элементом конфигурации, ASP.NET выдает ошибку сервера: "Неопознанный раздел конфигурации имя_элемента".

<configuration>
    <configSections>
        <sectionGroup name="system.web" type="System.Web.Configuration.SystemWebSectionGroup, System.Web, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%">
            <section name="authentication" type="System.Web.Configuration.AuthenticationSection, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowDefinition="MachineToApplication" />
            <!-- Other system.web sections -->
        </sectionGroup>
        <!-- Other configuration sections -->
    </configSections>

    <system.web>
        <authentication mode="Windows">
            <forms name=".ASPXAUTH" 
                   loginUrl="login.aspx" defaultUrl="default.aspx" 
                   protection="All" 
                   timeout="30" 
                   path="/" 
                   requireSSL="False" 
                   slidingExpiration="True" 
                   cookieless="UseCookies" 
                   domain="" 
                   enableCrossAppRedirects="False">
                <credentials passwordFormat="SHA1" />
            </forms>
            <passport redirectUrl="internal" />
        </authentication>
        <!-- Other system.web elements -->
    </system.web>
    <!-- Other configuration settings -->
</configuration>

Пример

В следующем примере кода демонстрируется способ определения пользовательского раздела конфигурации и его параметров.

<configuration>

   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>

   <sampleSection setting1="Value1" 
                  setting2="value two" 
                  setting3="third value" />

</configuration>

Сведения об элементе

Обработчик раздела конфигурации

Не применяется.

Элемент конфигурации

ConfigurationSectionCollection

ConfigurationSectionGroupCollection

Настраиваемые расположения

Machine.config

Файл Web.config корневого уровня

Файл Web.config уровня приложения

Файл Web.config уровня виртуального или физического каталога

Требования

Microsoft IIS версии 5.0, 5.1 или 6.0

.NET Framework версии 1.0, 1.1 или 2.0

Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Ссылки

Элемент configuration (схема общих параметров)

Элемент section для элемента configSections (схема общих параметров)

Элемент sectionGroup для элемента configSections (схема общих параметров)

Элемент clear для элемента configSections (схема общих параметров)

Элемент remove для элемента configSections (схема общих параметров)

Основные понятия

Иерархия и наследование файла конфигурации ASP.NET

Изменение файлов конфигурации ASP.NET

Сценарии конфигурации ASP.NET

Другие ресурсы

Общие параметры конфигурации (ASP.NET)

Параметры конфигурации ASP.NET

Файлы конфигурации ASP.NET

Администрирование веб-сайта ASP.NET

Конфигурационный API-интерфейс настройки ASP.NET