IConfigurationSectionHandler Interfaz

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Paquete:

System.Configuration.ConfigurationManager v8.0.0

Source:

IConfigurationSectionHandler.cs

Controla el acceso a determinadas secciones de configuración.

public interface class IConfigurationSectionHandler

public interface IConfigurationSectionHandler

type IConfigurationSectionHandler = interface

Public Interface IConfigurationSectionHandler

Derivado

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

Comentarios

Importante

IConfigurationSectionHandler está en desuso en .NET Framework 2.0 y versiones posteriores. Pero, porque se usa internamente, se ha mantenido. Puede encontrar un ejemplo en Cómo: Crear secciones de configuración personalizadas mediante IConfigurationSectionHandler. Si usa el ejemplo anterior, compílelo con .NET Framework versión 1.0 o 1.1.

En .NET Framework versión 2.0 y posteriores, debe derivar de la ConfigurationSection clase para implementar el controlador de sección de configuración relacionado. Puede encontrar un ejemplo en Cómo: Crear secciones de configuración personalizadas mediante ConfigurationSection.

Las instancias de la IConfigurationSectionHandler clase deben ser seguras para subprocesos y sin estado. El Create método debe ser invocable desde varios subprocesos simultáneamente.

Además, el objeto de configuración generado por el Create método debe ser seguro para subprocesos e inmutable. Dado que el sistema de configuración almacena en caché los objetos de configuración, es importante no modificar el argumento primario al Create método . Por ejemplo, si el valor devuelto de Create es solo una pequeña modificación del elemento primario, se deben realizar modificaciones reales en un clon del elemento primario, no en el original.

Métodos

Create(Object, Object, XmlNode)

Crea un controlador de secciones de configuración.