Delen via

Kenmerken van toepassingsinstellingen

  • Artikel

De architectuur voor toepassingsinstellingen biedt veel kenmerken die kunnen worden toegepast op de wrapperklasse voor toepassingeninstellingen of de afzonderlijke eigenschappen ervan. Deze kenmerken worden tijdens runtime onderzocht door de infrastructuur voor toepassingsinstellingen, vaak specifiek de instellingenprovider, om de werking ervan aan te passen aan de opgegeven behoeften van de aangepaste wrapper.

De volgende tabel bevat de kenmerken die kunnen worden toegepast op de wrapperklasse voor toepassingsinstellingen, de afzonderlijke eigenschappen van deze klasse of beide. Per definitie moet slechts één kenmerk van het bereik(UserScopedSettingAttribute of ApplicationScopedSettingAttribute) worden toegepast op elk en elke instellingeneigenschap.

Notitie

Een aangepaste instellingenprovider, afgeleid van de klasse SettingsProvider, is alleen vereist om de volgende drie kenmerken te herkennen: ApplicationScopedSettingAttribute, UserScopedSettingAttributeen DefaultSettingValueAttribute.

Attribuut Doel Beschrijving
SettingsProviderAttribute Beide Hiermee geeft u de korte naam van de instellingenprovider die moet worden gebruikt voor persistentie.

Als dit kenmerk niet is opgegeven, wordt ervan uitgegaan dat de standaardprovider, LocalFileSettingsProvider, wordt gebruikt.
UserScopedSettingAttribute Beide Hiermee definieert u een eigenschap als een toepassingsinstelling binnen het gebruikersbereik.
ApplicationScopedSettingAttribute Beide Hiermee definieert u een eigenschap als een toepassingsspecifieke instelling.
DefaultSettingValueAttribute Eigenschap Hiermee geeft u een tekenreeks op die door de provider kan worden gedeserialiseerd in de in code vastgelegde standaardwaarde voor deze eigenschap.

Dit kenmerk is niet vereist voor de LocalFileSettingsProvider en overschrijft een waarde die door dit kenmerk wordt geleverd als er al een waarde bestaat.
SettingsDescriptionAttribute Eigendom Biedt de beschrijvende test voor een afzonderlijke instelling, die voornamelijk wordt gebruikt door runtime- en ontwerptijdprogramma's.
SettingsGroupNameAttribute Klas Biedt een expliciete naam aan een groep instellingen. Als dit kenmerk ontbreekt, gebruikt ApplicationSettingsBase de naam van de wrapper-klasse.
SettingsGroupDescriptionAttribute Klas Biedt de beschrijvende test voor een instellingengroep, die voornamelijk wordt gebruikt door runtime- en ontwerptijdprogramma's.
SettingsManageabilityAttribute Beide Hiermee geeft u nul of meer beheerbaarheidsservices op die moeten worden geleverd aan de instellingengroep of eigenschap. De beschikbare services worden beschreven door de opsomming SettingsManageability.
SpecialSettingAttribute Eigenschap Hiermee wordt aangegeven dat een instelling deel uitmaakt van een speciale, vooraf gedefinieerde categorie, zoals een verbindingsreeks, die speciale verwerking door de instellingenprovider voorstelt. De vooraf gedefinieerde categorieën voor dit kenmerk worden gedefinieerd door de opsomming SpecialSetting.
SettingsSerializeAsAttribute Beide Bepaalt een voorkeursserialisatiemechanisme voor een instellingengroep of eigenschap. De beschikbare serialisatiemechanismen worden gedefinieerd door de opsomming SettingsSerializeAs.
NoSettingsVersionUpgradeAttribute Eigenschap Hiermee geeft u op dat een instellingenprovider alle functionaliteit voor het upgraden van toepassingen voor de gemarkeerde eigenschap moet uitschakelen.

Klasse geeft aan dat het kenmerk alleen kan worden toegepast op een wrapperklasse voor toepassingsinstellingen. eigenschap geeft aan dat het kenmerk alleen instellingeneigenschappen kan worden toegepast. Beide geeft aan dat het kenmerk op beide niveaus kan worden toegepast.

Zie ook