IConfigurationSectionHandler IConfigurationSectionHandler IConfigurationSectionHandler IConfigurationSectionHandler Interface

Definizione

Gestisce l'accesso a determinate sezioni di configurazione.Handles the access to certain configuration sections.

public interface class IConfigurationSectionHandler
public interface IConfigurationSectionHandler
type IConfigurationSectionHandler = interface
Public Interface IConfigurationSectionHandler
Derivato

Commenti

Importante

IConfigurationSectionHandlerè deprecato in .NET Framework 2,0 e versioni successive.IConfigurationSectionHandler is deprecated in .NET Framework 2.0 and above. Tuttavia, poiché viene utilizzata internamente, è stata mantenuta.But, because it is used internally, it has been kept. È possibile trovare un esempio in procedura: Creare sezioni di configurazione personalizzate usandoIConfigurationSectionHandler.You can find an example at How to: Create Custom Configuration Sections Using IConfigurationSectionHandler. Se si usa l'esempio precedente, compilarlo con il .NET Framework versione 1,0 o 1,1.If you use the previous example, please build it with the .NET Framework version 1.0 or 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.In .NET Framework version 2.0 and above, you must instead derive from the ConfigurationSection class to implement the related configuration section handler. È possibile trovare un esempio in procedura: Creare sezioni di configurazione personalizzate usandoConfigurationSection.You can find an example at How to: Create Custom Configuration Sections Using ConfigurationSection.

Le IConfigurationSectionHandler istanze della classe devono essere thread-safe e senza stato.Instances of the IConfigurationSectionHandler class must be thread safe and stateless. Il Create metodo deve essere chiamabile da più thread contemporaneamente.The Create method must be callable from multiple threads simultaneously.

Inoltre, l'oggetto di configurazione generato dal Create metodo deve essere thread-safe e non modificabile.Furthermore, the configuration object generated by the Create method must be thread safe and immutable. Poiché gli oggetti di configurazione vengono memorizzati nella cache dal sistema di configurazione, è importante non modificare l'argomento padre nel Create metodo.Because the configuration objects are cached by the configuration system, it is important not to modify the parent argument to the Create method. Se, ad esempio, il valore restituito Create di è solo una piccola modifica dell'elemento padre, è necessario apportare le modifiche effettive a un clone dell'elemento padre, non all'originale.For example, if the return value of Create is only a small modification of the parent, actual modifications must be made on a clone of the parent, not the original.

Metodi

Create(Object, Object, XmlNode) Create(Object, Object, XmlNode) Create(Object, Object, XmlNode) Create(Object, Object, XmlNode)

Crea un gestore della sezione di configurazione.Creates a configuration section handler.

Si applica a