SettingsProvider Klasse
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.
Fungiert als Basisklasse zum Ableiten benutzerdefinierter Einstellungsanbieter in der Anwendungseinstellungsarchitektur.
public ref class SettingsProvider abstract : System::Configuration::Provider::ProviderBasepublic abstract class SettingsProvider : System.Configuration.Provider.ProviderBasetype SettingsProvider = class
inherit ProviderBasePublic MustInherit Class SettingsProvider
Inherits ProviderBase- Vererbung
- 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:
Wenn der Anbieter die vom Attribut implizierte Anforderung erfüllen kann, sollte er dies natürlich tun.
Wenn der Anbieter die Anforderung nicht erfüllen kann, sollte er sie unbeaufsichtigt ignorieren.
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) |
