(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

SettingsProvider-Klasse

Fungiert als Basisklasse zum Ableiten benutzerdefinierter Einstellungsanbieter in der Anwendungseinstellungsarchitektur.

Namespace:  System.Configuration
Assembly:  System (in System.dll)
public abstract class SettingsProvider : ProviderBase

Der SettingsProvider-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Geschützte MethodeSettingsProviderInitialisiert eine Instanz der SettingsProvider-Klasse.
Zum Seitenanfang
  NameBeschreibung
Öffentliche EigenschaftApplicationNameRuft den Namen der aktuell ausgeführten Anwendung ab oder legt diesen fest.
Öffentliche EigenschaftDescriptionRuft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen geeignet ist. (Von ProviderBase geerbt.)
Öffentliche EigenschaftNameRuft den Anzeigennamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen. (Von ProviderBase geerbt.)
Zum Seitenanfang
  NameBeschreibung
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Öffentliche MethodeGetPropertyValuesGibt die Auflistung der Einstellungseigenschaftswerte für die angegebene Anwendungsinstanz und Einstellungseigenschaftengruppe zurück.
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeInitializeInitialisiert den Anbieter. (Von ProviderBase geerbt.)
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche MethodeSetPropertyValuesLegt die Werte der angegebenen Gruppe von Eigenschafteneinstellungen fest.
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

Ein Einstellungsanbieter definiert den Mechanismus zum Speichern von in der Anwendungseinstellungsarchitektur verwendeten Konfigurationsdaten. .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 SettingsProvider-Klasse erstellen. Der Anbieter, den eine Wrapperklasse verwendet, wird durch das Ergänzen der Wrapperklasse durch SettingsProviderAttribute bestimmt. Wenn dieses Attribut nicht bereitgestellt wird, wird der Standard, nämlich LocalFileSettingsProvider, verwendet.

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

Für Clientanwendungen können Sie einem benutzerdefinierten Anbieter mehrere standardisierte Funktionen hinzufügen, indem Sie auch die IApplicationSettingsProvider-Schnittstelle implementieren. Diese Schnittstelle gibt Methoden wieder, die in der ApplicationSettingsBase-Klasse gefunden wurden, die die Versionszuweisungsunterstützung aktiviert.

Sie sollten Einstellungsanbieter normalerweise so entwerfen, dass sie nur eine Instanz besitzen, um Speicherressourcenkonflikte zu vermeiden. Anbieter sollten außerdem threadsicher sein, weil sie gleichzeitig von mehreren Wrapperinstanzen in einer einzelnen Anwendungsdomäne oder von mehreren Anwendungen in verschiedenen Domänen aufgerufen werden können.

Ein Einstellungsanbieter muss mindestens drei Attribute erkennen: ApplicationScopedSettingAttribute, UserScopedSettingAttribute und DefaultSettingValueAttribute. Eine vollständige Auflistung der Attribute, die für Anwendungseinstellungen angewendet werden können, finden Sie unter Attribute für Anwendungseinstellungen. Ein benutzerdefinierter Einstellungsanbieter 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 auch tun.

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

  3. Wenn bei zwei oder mehr Eigenschaften ein Konflikt auftritt, z. B. dass eine Eigenschaft sowohl mit ApplicationScopedSettingAttribute als auch mitUserScopedSettingAttribute ergänzt wird, sollte der Anbieter eine ConfigurationException auslösen.

.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Vielen Dank für Ihr Feedback.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft. Alle Rechte vorbehalten.