IConfigurationSectionHandler Interfaccia

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Origine:

IConfigurationSectionHandler.cs

Gestisce l'accesso a determinate sezioni di configurazione.

C#

public interface IConfigurationSectionHandler

Derivato

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

Commenti

Importante

IConfigurationSectionHandler è deprecato in .NET Framework 2.0 e versioni successive. Ma, poiché viene usato internamente, è stato mantenuto. È possibile trovare un esempio in Procedura: Creare sezioni di configurazione personalizzate usando IConfigurationSectionHandler. Se si usa l'esempio precedente, compilarlo con .NET Framework versione 1.0 o 1.1.

In .NET Framework versione 2.0 e successive, è invece necessario derivare dalla ConfigurationSection classe per implementare il gestore della sezione di configurazione correlata. È possibile trovare un esempio in Procedura: Creare sezioni di configurazione personalizzate usando ConfigurationSection.

Le istanze della IConfigurationSectionHandler classe devono essere thread-safe e senza stato. Il Create metodo deve essere chiamabile da più thread contemporaneamente.

Inoltre, l'oggetto di configurazione generato dal Create metodo deve essere thread-safe e non modificabile. Poiché gli oggetti di configurazione vengono memorizzati nella cache dal sistema di configurazione, è importante non modificare l'argomento padre nel Create metodo . Ad esempio, se il valore restituito di Create è solo una piccola modifica dell'elemento padre, è necessario apportare modifiche effettive a un clone dell'elemento padre, non all'originale.

Metodi

Create(Object, Object, XmlNode)

Crea un gestore della sezione di configurazione.

Si applica a