IConfigurationSectionHandler Interface

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

IConfigurationSectionHandler.cs

Gère l’accès à certaines sections de configuration.

public interface class IConfigurationSectionHandler

public interface IConfigurationSectionHandler

type IConfigurationSectionHandler = interface

Public Interface IConfigurationSectionHandler

Dérivé

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

Remarques

Important

IConfigurationSectionHandler est déconseillé dans .NET Framework 2.0 et versions ultérieures. Mais, comme il est utilisé en interne, il a été conservé. Vous trouverez un exemple dans Guide pratique pour créer des sections de configuration personnalisée à l’aide d’IConfigurationSectionHandler. Si vous utilisez l’exemple précédent, générez-le avec .NET Framework version 1.0 ou 1.1.

Dans .NET Framework version 2.0 et ultérieures, vous devez plutôt dériver de la ConfigurationSection classe pour implémenter le gestionnaire de section de configuration associé. Vous trouverez un exemple dans Guide pratique pour créer des sections de configuration personnalisée à l’aide de ConfigurationSection.

Les instances de la IConfigurationSectionHandler classe doivent être thread-safe et sans état. La Create méthode doit être appelable à partir de plusieurs threads simultanément.

En outre, l’objet de configuration généré par la Create méthode doit être thread-safe et immuable. Étant donné que les objets de configuration sont mis en cache par le système de configuration, il est important de ne pas modifier l’argument parent à la Create méthode . Par exemple, si la valeur de retour de Create n’est qu’une petite modification du parent, les modifications réelles doivent être effectuées sur un clone du parent, et non sur l’original.

Méthodes

Create(Object, Object, XmlNode)

Crée un gestionnaire de section de configuration.