IConfigurationSectionHandler Интерфейс

Определение

Пространство имен:

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

Исходный код:

IConfigurationSectionHandler.cs

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

public interface class IConfigurationSectionHandler

public interface IConfigurationSectionHandler

type IConfigurationSectionHandler = interface

Public Interface IConfigurationSectionHandler

Производный

System.Configuration.DictionarySectionHandler

System.Configuration.IgnoreSectionHandler

System.Configuration.NameValueFileSectionHandler

System.Configuration.NameValueSectionHandler

System.Configuration.SingleTagSectionHandler

System.Data.Common.DbProviderConfigurationHandler

System.Data.Common.DbProviderFactoriesConfigurationHandler

System.Diagnostics.DiagnosticsConfigurationHandler

System.DirectoryServices.SearchWaitHandler

System.Web.Configuration.HttpCapabilitiesSectionHandler

System.Web.Configuration.ProtocolsConfigurationHandler

System.Web.Mobile.MobileDeviceCapabilitiesSectionHandler

System.Web.UI.MobileControls.MobileControlsSectionHandler

Комментарии

Важно!

IConfigurationSectionHandlerне рекомендуется использовать в платформа .NET Framework 2.0 и более поздних версий. Но, поскольку он используется внутри, он был сохранен. Пример см. в разделе Практическое руководство. Создание настраиваемых разделов конфигурации с помощью IConfigurationSectionHandler. Если вы используете предыдущий пример, выполните сборку с платформа .NET Framework версии 1.0 или 1.1.

В платформа .NET Framework версии 2.0 и более поздних версиях для реализации связанного ConfigurationSection обработчика разделов конфигурации необходимо наследовать от класса . Пример см. в разделе Практическое руководство. Создание настраиваемых разделов конфигурации с помощью ConfigurationSection.

Экземпляры IConfigurationSectionHandler класса должны быть потокобезопасными и без отслеживания состояния. Метод Create должен вызываться из нескольких потоков одновременно.

Кроме того, объект конфигурации, созданный методом Create , должен быть потокобезопасным и неизменяемым. Так как объекты конфигурации кэшируются системой конфигурации, важно не изменять родительский аргумент для Create метода . Например, если возвращаемое значение Create является лишь небольшим изменением родительского элемента, фактические изменения должны выполняться в клоне родительского объекта, а не в исходном.

Методы

Create(Object, Object, XmlNode)

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