Классы, использующиеся для создания обработчиков определенных разделов
Обновлен: Ноябрь 2007
Если ни один из существующих разделов конфигурации не подходит, можно создать отдельные разделы и создать обработчики для чтения и записи конфигурационных данных. Обработчик должен быть классом платформы .NET Framework, который расширяет класс ConfigurationSection.
.gif "Примечание") Примечание. |
|---|
В платформе .NET Framework версий 1.0 и 1.1, обработчик раздела конфигурации должен реализовывать интерфейс IConfigurationSectionHandler, который все еще поддерживается в платформе .NET Framework версии 2.0, но уже устарел. |
Пользовательские обработчики разделов конфигурации могут быть реализованы при помощи одной или двух моделей реализации: программная модель или декларативная модель.
Модель программной реализации
Эта модель требует для каждого атрибута раздела создания свойства для задания и/или считывания его значения и добавления его во внутреннюю коллекцию свойств основного базового класса ConfigurationElement.
Декларативная модель реализации
Эта модель, также известная как модель атрибутов, позволяет создавать атрибут раздела при помощи атрибутов свойств и настроек. Эти атрибуты вводят в систему настроек ASP.NET типы свойств и их значения по умолчанию. С этой информацией, полученной из отражения, система настроек ASP.NET создает объекты свойств разделов и выполняет требуемую инициализацию. Дополнительные сведения об отражении см. в разделе Общие сведения об отражении.
Классы, использующиеся для создания обработчиков определенных разделов
В следующей таблице перечислены ключевые классы, используемые для программного создания пользовательских обработчиков событий конфигурации.
В каждом из разделов класса, есть детализованные примеры кода, использующие одну или другую модель реализации. Или можно просмотреть упрощенный пример декларативного кода в разделе Практическое руководство. Создание пользовательских разделов конфигурации с помощью класса ConfigurationSection.
Классы, использующиеся для реализации обработчиков разделов |
Описание |
|---|---|
Класс ConfigurationSection |
Представляет раздел в конфигурационном файле. Использует ConfigurationSection для реализации пользовательского типа обработчика конфигурационных разделов. Расширяет класс ConfigurationSection для предоставления пользовательской обработки и программного доступа к пользовательским разделам конфигурации. Раздел регистрирует свой тип обработчика при помощи записи в элементе configSections конфигурационного файла. |
Представляет коллекцию связанных разделов в конфигурационном файле. Используйте ConfigurationSectionCollection в создании пользовательских типов, которые расширяют класс ConfigurationSection. Или используйте его при программном чтении файла конфигурации через коллекцию объектов ConfigurationSection. |
|
Представляет коллекцию элементов в конфигурационном файле. Используйте ConfigurationElementCollection для работы с коллекцией объектов ConfigurationElement. Реализуйте этот класс, чтобы добавить коллекцию пользовательских элементов ConfigurationElement в ConfigurationSection. |
|
Класс ConfigurationElement |
Представляет элемент в конфигурационном файле. Используйте ConfigurationElement как базовый класс для классов, представляющих элементы конфигурации XML, например, ConfigurationSection. Можно расширить класс ConfigurationElement для представления конфигурационного элемента в ConfigurationSection. Можно также создать ConfigurationElementCollection элементов ConfigurationElement. Каждый объект ConfigurationElement создает внутреннюю коллекцию ConfigurationPropertyCollection объектов ConfigurationProperty, которые представляют либо атрибуты элементов, либо коллекцию дочерних элементов. |
Декларативно заставляет платформу .NET Framework создать коллекцию свойств конфигурационных элементов. Используйте ConfigurationCollectionAttribute, чтобы добавить атрибуты в свойство ConfigurationElementCollection. Это заставляет платформу .NET Framework создать свойство и инициализировать его при помощи пользовательских значений ConfigurationElement. |
|
ConfigurationPropertyCollection класс представляет коллекцию объектов ConfigurationProperty, которые могут быть атрибутами или объектами ConfigurationElement элемента конфигурации. |
|
Класс ConfigurationProperty |
Представляет атрибут или дочерний конфигурационному элемент. В случае простого ConfigurationElement, объекты ConfigurationProperty представляют собой атрибуты. В случае более сложной конфигурации элементов, такой как раздел, содержащий подразделы, объекты ConfigurationProperty могут представлять объекты ConfigurationElement или атрибуты. Класс ConfigurationProperty представляет индивидуальную настройку конфигурации. Этот класс позволяет получать или задавать имя, тип и значение по умолчанию для отдельной записи конфигурации (атрибут или элемент) и указывать, требуется ли атрибут, есть ли ключ коллекции, или представлена ли коллекция элементов по умолчанию. |
Декларативно заставляет платформу .NET Framework создать свойство конфигурационных элементов. Используйте ConfigurationPropertyAttribute для оформления свойства конфигурационных элементов. Это заставляет платформу .NET Framework создать свойство и инициализировать его при помощи значения оформленного параметра. |
См. также
Задачи
Основные понятия
Структура файла конфигурации ASP.NET (разделы и обработчики разделов)