IConfigurationSectionHandler Интерфейс

Определение

Обрабатывает доступ к конкретным разделам конфигурации.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)

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

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