IConfigurationSectionHandler IConfigurationSectionHandler IConfigurationSectionHandler IConfigurationSectionHandler Interface

Определение

Обрабатывает доступ к конкретным разделам конфигурации.Handles the access to certain configuration sections.

public interface class IConfigurationSectionHandler
public interface IConfigurationSectionHandler
type IConfigurationSectionHandler = interface
Public Interface IConfigurationSectionHandler
Производный

Комментарии

Важно!

IConfigurationSectionHandlerне рекомендуется использовать в .NET Framework 2,0 и более поздних версиях.IConfigurationSectionHandler is deprecated in .NET Framework 2.0 and above. Но так как он используется внутренним образом, он был сохранен.But, because it is used internally, it has been kept. Пример можно найти в следующих руководствах: Создание пользовательских разделов конфигурации с помощьюиконфигуратионсектионхандлер.You can find an example at How to: Create Custom Configuration Sections Using IConfigurationSectionHandler. Если вы используете предыдущий пример, создайте его с помощью .NET Framework версии 1,0 или 1,1.If you use the previous example, please build it with the .NET Framework version 1.0 or 1.1.

В .NET Framework версии 2,0 и более поздних необходимо создать производный от ConfigurationSection класса класс для реализации соответствующего обработчика раздела конфигурации.In .NET Framework version 2.0 and above, you must instead derive from the ConfigurationSection class to implement the related configuration section handler. Пример можно найти в следующих руководствах: Создание пользовательских разделов конфигурации с помощьюConfigurationSection.You can find an example at How to: Create Custom Configuration Sections Using ConfigurationSection.

IConfigurationSectionHandler Экземпляры класса должны быть потокобезопасными и без отслеживания состояния.Instances of the IConfigurationSectionHandler class must be thread safe and stateless. Create Метод должен вызываться из нескольких потоков одновременно.The Create method must be callable from multiple threads simultaneously.

Более того, объект конфигурации, созданный Create методом, должен быть потокобезопасным и неизменяемым.Furthermore, the configuration object generated by the Create method must be thread safe and immutable. Поскольку объекты конфигурации кэшируются системой конфигурации, важно не изменять родительский аргумент Create метода.Because the configuration objects are cached by the configuration system, it is important not to modify the parent argument to the Create method. Например, если возвращаемое значение Create является лишь небольшим изменением родителя, фактические изменения должны выполняться для клона родителя, а не исходного.For example, if the return value of Create is only a small modification of the parent, actual modifications must be made on a clone of the parent, not the original.

Методы

Create(Object, Object, XmlNode) Create(Object, Object, XmlNode) Create(Object, Object, XmlNode) Create(Object, Object, XmlNode)

Создает обработчик раздела конфигурации.Creates a configuration section handler.

Применяется к