Sdílet prostřednictvím

Atributy nastavení aplikace

  • Článek

Architektura Nastavení aplikace poskytuje mnoho atributů, které lze použít buď na obálku nastavení aplikace, nebo její jednotlivé vlastnosti. Tyto atributy jsou zkoumány v době běhu infrastrukturou nastavení aplikace, často konkrétně poskytovatelem nastavení, aby bylo možné přizpůsobit jeho fungování podle uvedených potřeb vlastní obálky.

Následující tabulka uvádí atributy, které lze použít na obálku nastavení aplikace, jednotlivé vlastnosti této třídy nebo obojí. Podle definice musí být pro každou vlastnost nastavení použita pouze jeden atribut oboruUserScopedSettingAttribute nebo ApplicationScopedSettingAttribute.

Poznámka

Zprostředkovatel vlastních nastavení odvozený z třídy SettingsProvider je vyžadován pouze k rozpoznání následujících tří atributů: ApplicationScopedSettingAttribute, UserScopedSettingAttributea DefaultSettingValueAttribute.

Atribut Cíl Popis
SettingsProviderAttribute Oba Určuje krátký název zprostředkovatele nastavení, který se má použít pro trvalost.

Pokud tento atribut není zadán, předpokládá se výchozí zprostředkovatel LocalFileSettingsProvider.
UserScopedSettingAttribute Oba Definuje vlastnost jako uživatelsky ohraničené nastavení aplikace.
ApplicationScopedSettingAttribute Oba Definuje vlastnost jako nastavení aplikace v rámci rozsahu aplikace.
DefaultSettingValueAttribute Vlastnost Určuje řetězec, který může být deserializován poskytovatelem do pevně zakódované výchozí hodnoty pro tuto vlastnost.

LocalFileSettingsProvider nevyžaduje tento atribut a přepíše jakoukoli hodnotu poskytnutou tímto atributem, pokud je hodnota již zachována.
SettingsDescriptionAttribute Vlastnost Poskytuje popisný test pro individuální nastavení, používané především nástroji během běhu a při návrhu.
SettingsGroupNameAttribute Třída Poskytuje explicitní název skupiny nastavení. Pokud tento atribut chybí, ApplicationSettingsBase použije název třídy obálky.
SettingsGroupDescriptionAttribute Třída Poskytuje popisný test pro skupinu nastavení, která se používá především nástroji pro běh a návrh.
SettingsManageabilityAttribute Oba Určuje nula nebo více služeb spravovatelnosti, které by se měly poskytnout skupině nebo vlastnosti nastavení. Dostupné služby jsou popsány ve výčtu SettingsManageability.
SpecialSettingAttribute Vlastnost Označuje, že nastavení patří do speciální předdefinované kategorie, jako je připojovací řetězec, který navrhuje speciální zpracování poskytovatelem nastavení. Kategorie předdefinované pro tento atribut jsou definovány výčtem SpecialSetting.
SettingsSerializeAsAttribute Oba Určuje upřednostňovaný mechanismus serializace pro skupinu nebo vlastnost nastavení. Dostupné mechanismy serializace jsou definovány ve výčtu SettingsSerializeAs.
NoSettingsVersionUpgradeAttribute Nemovitost Určuje, že poskytovatel nastavení by měl zakázat všechny funkce upgradu aplikace pro označenou vlastnost.

třída označuje, že atribut lze použít pouze na třídu obálky nastavení aplikace. Vlastnost označuje, že atribut lze použít pouze na vlastnosti nastavení. Oba indikují, že atribut lze použít na obou úrovních.

Viz také