IConfigurationSectionHandler Interface

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v9.0.0-rc.2.24473.5

Origem:

IConfigurationSectionHandler.cs

Controla o acesso a determinadas seções de configuração.

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

Comentários

Importante

IConfigurationSectionHandler foi preterido no .NET Framework 2.0 e superior. Mas, como ele é usado internamente, ele foi mantido. Você pode encontrar um exemplo em Como criar seções de configuração personalizada usando IConfigurationSectionHandler. Se você usar o exemplo anterior, compile-o com o .NET Framework versão 1.0 ou 1.1.

No .NET Framework versão 2.0 e superior, você deve derivar da ConfigurationSection classe para implementar o manipulador de seção de configuração relacionado. Você pode encontrar um exemplo em Como criar seções de configuração personalizadas usando ConfigurationSection.

As instâncias da IConfigurationSectionHandler classe devem ser thread-safe e sem estado. O Create método deve ser chamado de vários threads simultaneamente.

Além disso, o objeto de configuração gerado pelo Create método deve ser thread-safe e imutável. Como os objetos de configuração são armazenados em cache pelo sistema de configuração, é importante não modificar o argumento pai para o Create método . Por exemplo, se o valor retornado de Create for apenas uma pequena modificação do pai, as modificações reais deverão ser feitas em um clone do pai, não no original.

Métodos

Create(Object, Object, XmlNode)

Cria um manipulador de seção de configuração.