IConfigurationSectionHandler Schnittstelle

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

IConfigurationSectionHandler.cs

Behandelt den Zugriff auf bestimmte Konfigurationsabschnitte.

public interface class IConfigurationSectionHandler

public interface IConfigurationSectionHandler

type IConfigurationSectionHandler = interface

Public Interface IConfigurationSectionHandler

Abgeleitet

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

Hinweise

Wichtig

IConfigurationSectionHandlerist 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 mithilfe von IConfigurationSectionHandler. Wenn Sie das vorherige Beispiel verwenden, erstellen Sie es mit der .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 der Rückgabewert von Create beispielsweise nur eine kleine Änderung des übergeordneten Elements ist, müssen tatsächliche Änderungen an einem Klon des übergeordneten Elements vorgenommen werden, nicht am ursprünglichen.

Methoden

Create(Object, Object, XmlNode)

Erstellt einen Konfigurationsabschnittshandler.