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

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

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

<sectionGroup 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token"
   <section />
/>

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

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

Атрибуты

Атрибут	Описание
name	Обязательный атрибут String. Задает имя раздела конфигурации или элемента, связанного с обработчиком раздела конфигурации, который указан с помощью атрибута type. Это имя элемента group в том виде, как оно отображается в области параметров раздела в файле конфигурации.
type	Обязательный атрибут String. Задает имя класса обработчика раздела конфигурации, обрабатывающего параметры конфигурации в разделе или элементе, который указан в атрибуте name. Используйте следующий формат. type="Полное имя класса,имя файла сборки,версия,национальный язык,маркер открытого ключа" Определение должно совпадать со ссылкой на сборку. Например, если номер версии в следующем примере кода не совпадает со сборкой, возникает ошибка. `type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"` Файл сборки должен находиться в том же каталоге приложения ASP.NET, что и файл Web.config, определяющий его. В случае с корневыми файлами Web.config или Machine.config файл сборки должен быть в каталоге %SystemRoot%\Microsoft.NET\Framework\версия.

Атрибут

Описание

name

Обязательный атрибут String.

Задает имя раздела конфигурации или элемента, связанного с обработчиком раздела конфигурации, который указан с помощью атрибута type. Это имя элемента group в том виде, как оно отображается в области параметров раздела в файле конфигурации.

type

Обязательный атрибут String.

Задает имя класса обработчика раздела конфигурации, обрабатывающего параметры конфигурации в разделе или элементе, который указан в атрибуте name. Используйте следующий формат.

type="Полное имя класса,имя файла сборки,версия,национальный язык,маркер открытого ключа"

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

type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"

Файл сборки должен находиться в том же каталоге приложения ASP.NET, что и файл Web.config, определяющий его. В случае с корневыми файлами Web.config или Machine.config файл сборки должен быть в каталоге %SystemRoot%\Microsoft.NET\Framework\версия.

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

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

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

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

Заметки

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

Настройки по умолчанию

Разделы конфигурации для элементов конфигурации .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>
      <sectionGroup name="mySectionGroup">
         <section name="mySection"
            type="System.Configuration.NameValueSectionHandler" />
      </sectionGroup>
   </configSections>
   <mySectionGroup>
      <mySection>
         <add key="key1" value="value1" />
      </mySection>
   </mySectionGroup>
</configuration>

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

Обработчик раздела конфигурации	Не применяется.
Элемент конфигурации	ConfigurationSectionGroup
Настраиваемые расположения	Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения Файл Web.config уровня виртуального или физического каталога
Требования	Microsoft IIS версии 5.0, 5.1 или 6.0 .NET Framework версии 2.0 Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

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