Attribute für Anwendungseinstellungen
Die Anwendungseinstellungs-Architektur stellt viele Attribute zur Verfügung, die entweder auf die Anwendungseinstellungs-Wrapperklasse oder die einzelnen Eigenschaften angewendet werden können. Diese Attribute werden zur Laufzeit von der Anwendungseinstellungsinfrastruktur, häufig dem Einstellungsanbieter, untersucht, um ihre Funktionsweise an die angegebenen Anforderungen des benutzerdefinierten Wrappers anzupassen.
In der folgenden Tabelle sind die Attribute aufgeführt, die auf die Wrapperklasse für Anwendungseinstellungen, die einzelnen Eigenschaften dieser Klasse oder beides angewendet werden können. Standardmäßig muss nur ein einzelnes Bereichsattribut –UserScopedSettingAttribute oder ApplicationScopedSettingAttribute-– auf jede Einstellungseigenschaft angewendet werden.
Anmerkung
Ein benutzerdefinierter Einstellungsanbieter, der von der SettingsProvider-Klasse abgeleitet ist, muss lediglich die folgenden drei Attribute erkennen: ApplicationScopedSettingAttribute, UserScopedSettingAttributeund DefaultSettingValueAttribute.
| Attribut | Ziel | Beschreibung |
|---|---|---|
| SettingsProviderAttribute | Beide | Gibt den Kurznamen des Einstellungenanbieters an, der zur Persistenz verwendet werden soll. Wenn dieses Attribut nicht angegeben wird, wird der Standardanbieter LocalFileSettingsProviderangenommen. |
| UserScopedSettingAttribute | Beide | Definiert eine Eigenschaft als benutzerspezifische Anwendungseinstellung. |
| ApplicationScopedSettingAttribute | Beide | Definiert eine Eigenschaft als anwendungsspezifische Anwendungseinstellung. |
| DefaultSettingValueAttribute | Eigentum | Gibt eine Zeichenfolge an, die durch den Anbieter in den fest vorgegebenen Standardwert für diese Eigenschaft deserialisiert werden kann. Das LocalFileSettingsProvider benötigt dieses Attribut nicht und überschreibt alle durch dieses Attribut bereitgestellten Werte, wenn bereits ein Wert gespeichert ist. |
| SettingsDescriptionAttribute | Eigentum | Stellt den beschreibenden Test für eine einzelne Einstellung bereit, die hauptsächlich von Laufzeit- und Entwurfszeittools verwendet wird. |
| SettingsGroupNameAttribute | Klasse | Stellt einen expliziten Namen für eine Einstellungsgruppe bereit. Wenn dieses Attribut fehlt, verwendet ApplicationSettingsBase den Namen der Wrapperklasse. |
| SettingsGroupDescriptionAttribute | Klasse | Stellt den beschreibenden Test für eine Einstellungsgruppe bereit, die hauptsächlich von Laufzeit- und Entwurfszeittools verwendet wird. |
| SettingsManageabilityAttribute | Beide | Gibt null oder mehr Verwaltbarkeitsdienste an, die der Einstellungsgruppe oder Eigenschaft bereitgestellt werden sollen. Die verfügbaren Dienste werden durch die SettingsManageability Enumeration beschrieben. |
| SpecialSettingAttribute | Eigentum | Gibt an, dass eine Einstellung zu einer speziellen vordefinierten Kategorie gehört, z. B. einer Verbindungszeichenfolge, die eine spezielle Verarbeitung durch den Einstellungsanbieter vorschlägt. Die vordefinierten Kategorien für dieses Attribut werden durch die SpecialSetting-Aufzählung definiert. |
| SettingsSerializeAsAttribute | Beide | Gibt einen bevorzugten Serialisierungsmechanismus für eine Einstellungsgruppe oder Eigenschaft an. Die verfügbaren Serialisierungsmechanismen werden durch die SettingsSerializeAs Enumeration definiert. |
| NoSettingsVersionUpgradeAttribute | Eigentum | Gibt an, dass ein Einstellungsanbieter alle Anwendungsupgradefunktionen für die markierte Eigenschaft deaktivieren soll. |
Class gibt an, dass das Attribut nur auf eine Anwendungseinstellungswrapperklasse angewendet werden kann. Property gibt an, dass das Attribut nur auf eine Einstellungseigenschaft Anwendung finden kann. Beide deuten darauf hin, dass das Attribut auf beiden Ebenen angewendet werden kann.
Siehe auch
.NET Desktop feedback