Sdílet prostřednictvím

Atributy nastavení aplikace

  • Článek

Architektura Nastavení aplikace poskytuje mnoho atributů, které lze použít buď u třídy obálky nastavení aplikací, nebo jeho jednotlivých vlastností. 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 oboru – UserScopedSettingAttribute nebo ApplicationScopedSettingAttribute.

Poznámka:

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

Atribut Cíl Popis
SettingsProviderAttribute Obojí 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 Obojí Definuje vlastnost jako nastavení aplikace v oboru uživatele.
ApplicationScopedSettingAttribute Obojí Definuje vlastnost jako nastavení aplikace v oboru 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.

Tento LocalFileSettingsProvider atribut nevyžaduje a přepíše jakoukoli hodnotu poskytnutou tímto atributem, pokud je hodnota již zachována.
SettingsDescriptionAttribute Vlastnost Poskytuje popisný test pro jednotlivá nastavení, která se používají především nástroji pro běh a návrh.
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 Obojí 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 výčtem SettingsManageability .
SpecialSettingAttribute Vlastnost Označuje, že nastavení patří do speciální předdefinované kategorie, například připojovací řetězec, která navrhuje speciální zpracování poskytovatelem nastavení. Předdefinované kategorie pro tento atribut jsou definovány výčtem SpecialSetting .
SettingsSerializeAsAttribute Obojí Určuje upřednostňovaný mechanismus serializace pro skupinu nebo vlastnost nastavení. Dostupné mechanismy serializace jsou definovány výčtem SettingsSerializeAs .
NoSettingsVersionUpgradeAttribute Vlastnost 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 obálku nastavení aplikace. Vlastnost označuje, že atribut lze použít pouze vlastnosti nastavení. Oba značí, že atribut lze použít na obou úrovních.

Viz také