IConfigurationSectionHandler Schnittstelle

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v9.0.0-rc.2.24473.5

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

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.