Attribut för programinställningar
Arkitekturen Programinställningar innehåller många attribut som kan tillämpas antingen på programinställningarnas omslutningsklass eller dess enskilda egenskaper. Dessa attribut granskas vid körning av infrastrukturen för programinställningar, ofta specifikt inställningsprovidern, för att anpassa dess funktion till de angivna behoven hos den anpassade omslutningen.
I följande tabell visas de attribut som kan tillämpas på omslutningsklassen för programinställningar, den här klassens enskilda egenskaper eller båda. Per definition måste endast ett enda omfångsattribut–UserScopedSettingAttribute eller ApplicationScopedSettingAttribute– tillämpas på varje egenskap för inställningar.
Not
En provider för anpassade inställningar, härledd från klassen SettingsProvider, krävs bara för att identifiera följande tre attribut: ApplicationScopedSettingAttribute, UserScopedSettingAttributeoch DefaultSettingValueAttribute.
| Attribut | Mål | Beskrivning |
|---|---|---|
| SettingsProviderAttribute | Båda | Anger det korta namnet på den inställningsprovider som ska användas för beständighet. Om det här attributet inte anges antas standardprovidern LocalFileSettingsProvider. |
| UserScopedSettingAttribute | Båda | Definierar en egenskap som en användarspecifik programinställning. |
| ApplicationScopedSettingAttribute | Båda | Definierar en egenskap som en programspecifik programinställning. |
| DefaultSettingValueAttribute | Egenskap | Anger en sträng som kan deserialiseras av providern till det hårdkodade standardvärdet för den här egenskapen. LocalFileSettingsProvider kräver inte det här attributet och åsidosätter alla värden som tillhandahålls av det här attributet om ett värde redan finns kvar. |
| SettingsDescriptionAttribute | Egenskap | Tillhandahåller det beskrivande testet för en enskild inställning, som främst används av körnings- och designtidsverktyg. |
| SettingsGroupNameAttribute | Klass | Ger ett explicit namn för en inställningsgrupp. Om det här attributet saknas använder ApplicationSettingsBase omslutningsklassnamnet. |
| SettingsGroupDescriptionAttribute | Klass | Tillhandahåller det beskrivande testet för en inställningsgrupp, som främst används av körnings- och designtidsverktyg. |
| SettingsManageabilityAttribute | Båda | Anger noll eller fler hanterbarhetstjänster som ska tillhandahållas till inställningsgruppen eller egenskapen. De tillgängliga tjänsterna beskrivs av SettingsManageability enumeration. |
| SpecialSettingAttribute | Egenskap | Anger att en inställning tillhör en särskild, fördefinierad kategori, till exempel en anslutningssträng, som föreslår särskild bearbetning av inställningsprovidern. De fördefinierade kategorierna för det här attributet definieras av SpecialSetting uppräkning. |
| SettingsSerializeAsAttribute | Båda | Anger en önskad serialiseringsmekanism för en inställningsgrupp eller egenskap. De tillgängliga serialiseringsmekanismerna definieras av SettingsSerializeAs uppräkning. |
| NoSettingsVersionUpgradeAttribute | Egenskap | Anger att en inställningsprovider ska inaktivera alla programuppgraderingsfunktioner för den markerade egenskapen. |
Klass anger att attributet endast kan tillämpas på en programinställningars wrapper-klass. Egenskap anger att attributet endast kan användas med inställningsegenskaper. Båda anger att attributet kan tillämpas på båda nivåer.
Se även
.NET Desktop feedback