IConfigurationSectionHandler Schnittstelle

  • Referenz

Definition

Namespace:
System.Configuration
Assembly:
System.Configuration.ConfigurationManager.dll
Assembly:
System.dll
Paket:
System.Configuration.ConfigurationManager v8.0.1
Paket:
System.Configuration.ConfigurationManager v9.0.0-rc.2.24473.5
Quelle:
IConfigurationSectionHandler.cs
Quelle:
IConfigurationSectionHandler.cs

Behandelt den Zugriff auf bestimmte Konfigurationsabschnitte.

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

Hinweise

Wichtig

IConfigurationSectionHandler ist in .NET Framework 2.0 und höher veraltet. Da es jedoch intern verwendet wird, wurde es beibehalten. Ein Beispiel finden Sie unter Vorgehensweise: Erstellen benutzerdefinierter Konfigurationsabschnitte mit IConfigurationSectionHandler. Wenn Sie das vorherige Beispiel verwenden, erstellen Sie es mit .NET Framework, Version 1.0 oder 1.1.

In .NET Framework Version 2.0 und höher müssen Sie stattdessen von der ConfigurationSection -Klasse ableiten, um den handler für den entsprechenden Konfigurationsabschnitt zu implementieren. Ein Beispiel finden Sie unter Vorgehensweise: Erstellen benutzerdefinierter Konfigurationsabschnitte mithilfe von ConfigurationSection.

Instanzen der IConfigurationSectionHandler -Klasse müssen threadsicher und zustandslos sein. Die Create -Methode muss von mehreren Threads gleichzeitig aufgerufen werden können.

Darüber hinaus muss das von der Create -Methode generierte Konfigurationsobjekt threadsicher und unveränderlich sein. Da die Konfigurationsobjekte vom Konfigurationssystem zwischengespeichert werden, ist es wichtig, das übergeordnete Argument nicht an die Create -Methode zu ändern. Wenn beispielsweise der Rückgabewert von Create nur eine kleine Änderung des übergeordneten Elements ist, müssen tatsächliche Änderungen an einem Klon des übergeordneten Elements vorgenommen werden, nicht an der originalen.

Methoden

Create(Object, Object, XmlNode)

Erstellt einen Konfigurationsabschnittshandler.

Gilt für: