SettingsProvider Klasse

Definition

Fungiert als Basisklasse zum Ableiten benutzerdefinierter Einstellungsanbieter 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
SettingsProvider
Abgeleitet

Hinweise

Ein Einstellungsanbieter definiert den Mechanismus zum Speichern von Konfigurationsdaten, die in der Anwendungseinstellungsarchitektur verwendet werden. Die .NET Framework enthält einen einzelnen Standardeinstellungsanbieter, LocalFileSettingsProviderder 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 SettingsProviderAttributebestimmt. Wenn dieses Attribut nicht angegeben wird, wird der Standardwert LocalFileSettingsProviderverwendet.

Wenn Sie einen anbieter für benutzerdefinierte Einstellungen erstellen, müssen Sie mindestens Implementierungen für die drei Methoden dieser Klasse bereitstellen: GetPropertyValues, SetPropertyValues und ApplicationName.

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 Versionsverwaltungsunterstützung ermöglicht.

In der Regel sollten Sie Einstellungsanbieter so entwerfen, dass sie einzelinstanzend sind, um Konflikte mit Speicherressourcen zu vermeiden. Anbieter sollten auch threadsicher sein, da sie gleichzeitig von mehreren Wrapperinstanzen in einer einzelnen Anwendungsdomäne oder von mehreren Anwendungen in verschiedenen Domänen aufgerufen werden können.

Mindestens muss ein Einstellungsanbieter drei Attribute erkennen: ApplicationScopedSettingAttribute, UserScopedSettingAttributeund DefaultSettingValueAttribute. Eine vollständige Liste der Attribute, die auf Anwendungseinstellungen angewendet werden können, finden Sie unter Attribute für Anwendungseinstellungen. Ein anbieter für benutzerdefinierte Einstellungen sollte Attribute, die auf Einstellungseigenschaften angewendet werden, wie folgt auflösen:

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

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

  3. Wenn zwei oder mehr Eigenschaften konflikten; Beispiel: Eine Eigenschaft, die mit ApplicationScopedSettingAttribute und UserScopedSettingAttributeversehen wird. Der Anbieter sollte einen ConfigurationExceptionauslösen.

Konstruktoren

SettingsProvider()

Initialisiert eine Instanz der SettingsProvider-Klasse.

Eigenschaften

ApplicationName

Ruft den Namen der aktuell ausgeführten Anwendung ab oder legt diesen fest.

Description

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

(Geerbt von ProviderBase)
Name

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

(Geerbt von ProviderBase)

Methoden

Equals(Object)

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

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetPropertyValues(SettingsContext, SettingsPropertyCollection)

Gibt die Auflistung der Einstellungseigenschaftswerte für die angegebene Anwendungsinstanz und Einstellungseigenschaftengruppe zurück.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
Initialize(String, NameValueCollection)

Initialisiert den Konfigurations-Generator.

(Geerbt von ProviderBase)
MemberwiseClone()

Erstellt eine flache Kopie des 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:

Siehe auch