IConfigurationSectionHandler 接口
本文内容
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
处理对特定的配置节的访问。
public interface class IConfigurationSectionHandler
public interface IConfigurationSectionHandler
type IConfigurationSectionHandler = interface
Public Interface IConfigurationSectionHandler
- 派生
注解
重要
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, Xml |
创建配置节处理程序。 |
适用于
产品 | 版本 |
---|---|
.NET | 8 (package-provided), 9 (package-provided), 10 (package-provided) |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |