Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

SettingsProvider-Klasse

 

Veröffentlicht: Oktober 2016

Fungiert als Basisklasse zum Ableiten benutzerdefinierter Einstellungsanbieter in der Architektur der Anwendungseinstellungen.

Namespace:   System.Configuration
Assembly:  System (in System.dll)


public abstract class SettingsProvider : ProviderBase

NameBeschreibung
System_CAPS_protmethodSettingsProvider()

Initialisiert eine Instanz der SettingsProvider-Klasse.

NameBeschreibung
System_CAPS_pubpropertyApplicationName

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

System_CAPS_pubpropertyDescription

Ruft eine kurze, benutzerfreundliche Beschreibung ab, das für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen (UIs) geeignet.(Geerbt von „ProviderBase“.)

System_CAPS_pubpropertyName

Ruft den angezeigten Namen verwendet, um während der Konfiguration auf den Anbieter zu verweisen.(Geerbt von „ProviderBase“.)

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetPropertyValues(SettingsContext, SettingsPropertyCollection)

Gibt die Auflistung der Einstellungen für die angegebene Anwendung und Einstellungen zurück.

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodInitialize(String, NameValueCollection)

Initialisiert den Anbieter.(Geerbt von „ProviderBase“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodSetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Legt die Werte für die angegebene Gruppe von Eigenschaften.

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

Ein Einstellungsanbieter definiert den Mechanismus zum Speichern von Konfigurationsdaten, die Architektur der Anwendung Einstellungen. .NET Framework enthält einen einzelnen Standardeinstellungsanbieter LocalFileSettingsProvider, der Konfigurationsdaten im lokalen Dateisystem speichert. Sie können alternative Speichermechanismen jedoch durch Ableiten von der abstrakten erstellen SettingsProvider Klasse. Der Anbieter, der eine Wrapperklasse verwendet wird bestimmt durch das ergänzen der Wrapperklasse durch die SettingsProviderAttribute. Wenn dieses Attribut nicht angegeben, wird die Standardeinstellung ist LocalFileSettingsProvider, verwendet wird.

Wenn Sie mindestens einen benutzerdefinierten Einstellungsanbieter verwenden, erstellen, müssen Sie Implementierungen für die drei Methoden dieser Klasse angeben: GetPropertyValues, SetPropertyValues und ApplicationName.

Für Clientanwendungen können Sie mehrere standardisierte Funktionen zu einem benutzerdefinierten Anbieter hinzufügen, indem Sie implementieren auch die IApplicationSettingsProvider Schnittstelle. Diese Schnittstelle in Methoden spiegelt die ApplicationSettingsBase Klasse, die in erster Linie Unterstützung ermöglicht.

In der Regel sollten Sie Einstellungsanbieter Einzelinstanzformat vermeiden zu entwerfen. Anbieter sollten auch threadsicher sein, da sie gleichzeitig von mehreren Wrapper-Instanzen in einer einzelnen Anwendungsdomäne oder aus mehreren Anwendungen in verschiedenen Domänen aufgerufen werden können.

Ein Einstellungsanbieter muss mindestens drei Attribute erkennen:ApplicationScopedSettingAttribute, UserScopedSettingAttribute, und DefaultSettingValueAttribute. Eine vollständige Liste der Attribute, die auf die Anwendungseinstellungen angewendet werden können, finden Sie unter Attribute für Anwendungseinstellungen. Ein benutzerdefinierter Einstellungsanbieter sollte Attribute, die auf Einstellungseigenschaften angewendet werden, auf folgende Weise beheben:

  1. Wenn der Anbieter die vom Attribut implizierte Anforderung erfüllen kann, sollten natürlich es tun.

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

  3. Wenn zwei oder mehr Eigenschaften in Konflikt stehen; z. B. eine Eigenschaft wird mit den beiden ApplicationScopedSettingAttribute und UserScopedSettingAttribute; sollte der Anbieter löst ein ConfigurationException.

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: