SettingsProvider Klasse

Definition

Namespace:
System.Configuration
Assembly:
System.dll

Dient als Basisklasse zum Ableiten von benutzerdefinierten Einstellungsanbietern in der Anwendungseinstellungsarchitektur.

public ref class SettingsProvider abstract : System::Configuration::Provider::ProviderBase
public abstract class SettingsProvider : System.Configuration.Provider.ProviderBase
type SettingsProvider = class
    inherit ProviderBase
Public MustInherit Class SettingsProvider
Inherits ProviderBase
Vererbung
Object
ProviderBase
SettingsProvider
Abgeleitet

Hinweise

Ein Einstellungsanbieter definiert den Mechanismus zum Speichern von Konfigurationsdaten, die in der Anwendungseinstellungsarchitektur verwendet werden. .NET Framework enthält einen einzigen Standardeinstellungsanbieter, LocalFileSettingsProvider, der Konfigurationsdaten im lokalen Dateisystem speichert. Sie können jedoch alternative Speichermechanismen erstellen, indem Sie von der abstrakten SettingsProvider Klasse abgeleitet werden. Der Anbieter, den eine Wrapperklasse verwendet, wird durch Das Dekorieren der Wrapperklasse mit der SettingsProviderAttribute. Wenn dieses Attribut nicht angegeben wird, wird der Standardwert verwendet LocalFileSettingsProvider.

Wenn Sie einen benutzerdefinierten Einstellungsanbieter erstellen, müssen Sie mindestens Implementierungen für die drei Methoden dieser Klasse bereitstellen: GetPropertyValuesund SetPropertyValuesApplicationName.

Für Clientanwendungen können Sie einem benutzerdefinierten Anbieter mehr standardisierte Funktionen hinzufügen, indem Sie auch die IApplicationSettingsProvider Schnittstelle implementieren. Diese Schnittstelle spiegelt Methoden in der ApplicationSettingsBase Klasse, die hauptsächlich die Versionsverwaltungsunterstützung ermöglicht.

In der Regel sollten Sie Die Anbieter von Einstellungen so entwerfen, dass sie nur instanziert werden, um Speicherressourcenkonflikt zu vermeiden. Anbieter sollten auch threadsicher sein, da sie gleichzeitig von mehreren Wrapperinstanzen in einer einzigen Anwendungsdomäne oder aus mehreren Anwendungen in unterschiedlichen Domänen aufgerufen werden können.

Mindestens muss ein Einstellungsanbieter drei Attribute erkennen : ApplicationScopedSettingAttribute, UserScopedSettingAttributeund DefaultSettingValueAttribute. Eine vollständige Auflistung der Attribute, die auf Anwendungseinstellungen angewendet werden können, finden Sie unter Anwendungseinstellungenattribute. Ein benutzerdefinierter Einstellungsanbieter sollte Attribute auflösen, die auf Einstellungseigenschaften angewendet werden:

  1. Wenn der Anbieter die vom Attribut implizierte Anforderung erfüllen kann, sollte dies offensichtlich tun.

  2. Wenn der Anbieter die Anforderung nicht erfüllen kann, sollte er sie im Hintergrund ignorieren.

  3. Wenn zwei oder mehr Eigenschaften in Konflikt geraten; Beispiel: Eine Eigenschaft, die mit beiden ApplicationScopedSettingAttribute und UserScopedSettingAttribute; der Anbieter sollte einen ConfigurationException.

Konstruktoren

Name Beschreibung
SettingsProvider()

Initialisiert eine Instanz der SettingsProvider Klasse.

Eigenschaften

Name Beschreibung
ApplicationName

Dient zum Abrufen oder Festlegen des Namens der derzeit ausgeführten Anwendung.
Description

Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen (UIs) geeignet ist.

(Geerbt von ProviderBase)
Name

Ruft den Anzeigenamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen.

(Geerbt von ProviderBase)

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetPropertyValues(SettingsContext, SettingsPropertyCollection)

Gibt die Auflistung der Einstellungseigenschaftenwerte für die angegebene Anwendungsinstanz und die Einstellungseigenschaftsgruppe zurück.
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
Initialize(String, NameValueCollection)

Initialisiert den Konfigurations-Generator.

(Geerbt von ProviderBase)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Legt die Werte der angegebenen Gruppe von Eigenschafteneinstellungen fest.
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen