Attribute für Anwendungseinstellungen
Die Architektur der Anwendungseinstellungen bietet zahlreiche Attribute, die entweder auf die Wrapperklasse der Anwendungseinstellungen oder ihre einzelnen Eigenschaften angewendet werden können. Diese Attribute werden zur Laufzeit von der Infrastruktur der Anwendungseinstellungen überprüft, häufig speziell der Anbieter der Einstellungen, um sie an die Anforderungen des benutzerdefinierten Wrappers anzupassen.
In der folgenden Tabelle werden die Attribute aufgelistet, die auf die Wrapperklasse der Anwendungseinstellungen, die einzelnen Eigenschaften dieser Klasse oder beides angewendet werden können. Definitionsgemäß muss auf jede Einstellungseigenschaft nur ein einziges Bereichsattribut – UserScopedSettingAttribute oder ApplicationScopedSettingAttribute – angewendet werden.
Tipp
Ein benutzerdefinierter Einstellungsanbieter, der von der SettingsProvider-Klasse abgeleitet wird, ist nur zum Erkennen der folgenden drei Attribute erforderlich: ApplicationScopedSettingAttribute, UserScopedSettingAttribute und DefaultSettingValueAttribute.
Attribut |
Target |
Beschreibung |
|---|---|---|
Beides |
Gibt den kurzen Namen des Einstellungsanbieters an, der zur Beibehaltung verwendet werden soll. Wenn dieses Attribut nicht angegeben wird, wird vom Standardanbieter LocalFileSettingsProvider ausgegangen. |
|
Beides |
Definiert eine Eigenschaft als benutzerspezifische Anwendungseinstellung. |
|
Beides |
Definiert eine Eigenschaft als anwendungsspezifische Einstellung. |
|
Eigenschaft |
Gibt eine Zeichenfolge an, die vom Anbieter in den fest definierten Standardwert für diese Eigenschaft deserialisiert werden kann. Dieses Attribut ist für LocalFileSettingsProvider nicht erforderlich und überschreibt jeden Wert, der von diesem Attribut bereitgestellt wird, wenn bereits ein Wert erhalten bleibt. |
|
Eigenschaft |
Stellt den beschreibenden Text für eine einzelne Einstellung bereit, die hauptsächlich von Tools zur Laufzeit und zur Entwurfszeit verwendet wird. |
|
Klasse |
Stellt einen expliziten Namen für eine Einstellungsgruppe bereit. Wenn dieses Attribut fehlt, verwendet ApplicationSettingsBase den Wrapperklassennamen. |
|
Klasse |
Stellt den beschreibenden Text für eine Einstellungsgruppe bereit, die hauptsächlich von Tools zur Laufzeit und zur Entwurfszeit verwendet wird. |
|
Beides |
Gibt null oder mehr Verwaltungsdienste an, die für die Einstellungsgruppe oder die Eigenschaft bereitgestellt werden sollten. Die verfügbaren Dienste werden von der SettingsManageability-Enumeration beschrieben. |
|
Eigenschaft |
Gibt an, dass eine Einstellung zu einer bestimmten, vordefinierten Kategorie, z. B. eine Kategoriezeichenfolge, gehört, die eine spezielle Verarbeitung durch den Einstellungsanbieter vorsieht. Die vordefinierten Kategorien für dieses Attribut werden von der SpecialSetting-Enumeration definiert. |
|
Beides |
Legt einen bevorzugten Serialisierungsmechanismus für eine Einstellungsgruppe oder eine Eigenschaft fest. Die verfügbaren Serialisierungsmechanismen werden von der SettingsSerializeAs-Enumeration definiert. |
|
Eigenschaft |
Legt fest, dass ein Einstellungsanbieter sämtliche Funktionen zur Anwendungsaktualisierung für die markierte Eigenschaft deaktivieren sollte. |
Klasse gibt an, dass das Attribut nur auf eine Wrapperklasse für Anwendungseinstellungen angewendet werden kann. Eigenschaft gibt an, dass das Attribut nur auf Einstellungseigenschaften angewendet werden kann. Beides gibt an, dass das Attribut auf beiden Ebenen angewendet werden kann.
Siehe auch
Aufgaben
Gewusst wie: Erstellen von Anwendungseinstellungen mithilfe des Designers