IConfigurationSectionHandler Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für