IConfigurationSectionHandler Интерфейс

Определение

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

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v9.0.0-preview.5.24306.7

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

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)

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