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 è obsoleta in .NET Framework 2.0 e versioni successive.IConfigurationSectionHandler is deprecated in .NET Framework 2.0 and above. Tuttavia, poiché viene usato internamente, è stata mantenuta.But, because it is used internally, it has been kept. È possibile trovare un esempio, vedere come: Creare sezioni di configurazione personalizzate usando IConfigurationSectionHandler.You can find an example at How to: Create Custom Configuration Sections Using IConfigurationSectionHandler. Se si usa l'esempio precedente, compilarla con .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 versioni successive, è invece necessario derivare dal ConfigurationSection classe per implementare il gestore della sezione di configurazione correlate.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, vedere come: Creare sezioni di configurazione personalizzate usando ConfigurationSection.You can find an example at How to: Create Custom Configuration Sections Using ConfigurationSection.

Le istanze del IConfigurationSectionHandler classe deve essere thread-safe e senza stato.Instances of the IConfigurationSectionHandler class must be thread safe and stateless. Il Create metodo deve essere chiamato 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 memorizzate nella cache dal sistema di configurazione, è importante non modificare l'argomento padre il 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. Ad esempio, se il valore restituito di Create è solo una piccola modifica dell'elemento padre, è necessario apportare le modifiche effettive in un clone dell'elemento padre, non l'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