Alkalmazásbeállítások attribútumai

Az Alkalmazásbeállítások architektúra számos attribútumot biztosít, amelyek alkalmazhatók az alkalmazásbeállítások burkolóosztályára vagy annak egyedi tulajdonságaira. Ezeket az attribútumokat futásidőben vizsgálja meg az alkalmazásbeállítások infrastruktúrája, gyakran kifejezetten a beállításszolgáltató, annak érdekében, hogy működését az egyéni burkoló megadott igényeihez igazítsuk.

Az alábbi táblázat az alkalmazásbeállítások burkolóosztályára, az osztály egyedi tulajdonságaira vagy mindkettőre alkalmazható attribútumokat sorolja fel. Definíció szerint csak egyetlen hatókörattribútumot –UserScopedSettingAttribute vagy ApplicationScopedSettingAttribute– kell alkalmazni minden egyes beállítástulajdonságra.

Megjegyzés:

A SettingsProvider osztályból származó egyéni beállításszolgáltató csak a következő három attribútum felismeréséhez szükséges: ApplicationScopedSettingAttribute, UserScopedSettingAttributeés DefaultSettingValueAttribute.

Jellemző	Cél	Leírás
SettingsProviderAttribute	Mindkettő	Megadja az adatmegőrzéshez használni kívánt beállításszolgáltató rövid nevét. Ha ez az attribútum nincs megadva, a rendszer feltételezi az alapértelmezett LocalFileSettingsProviderszolgáltatót.
UserScopedSettingAttribute	Mindkettő	A tulajdonságot felhasználó hatókörű alkalmazásbeállításként definiálja.
ApplicationScopedSettingAttribute	Mindkettő	Egy tulajdonságot alkalmazáshatókörű alkalmazásbeállításként definiál.
DefaultSettingValueAttribute	Ingatlan	Olyan karakterláncot ad meg, amelyet a szolgáltató deszerializálhat ezen tulajdonság kódolt alapértelmezett értékére. A LocalFileSettingsProvider nem igényli ezt az attribútumot, és felülbírálja az attribútum által megadott értékeket, ha már van már megőrzött érték.
SettingsDescriptionAttribute	Ingatlan	Az egyéni beállítások leíró tesztje, amelyet elsősorban a futásidejű és a tervezési idejű eszközök használnak.
SettingsGroupNameAttribute	Osztály	Explicit nevet ad egy beállításcsoportnak. Ha ez az attribútum hiányzik, ApplicationSettingsBase a burkolóosztály nevét használja.
SettingsGroupDescriptionAttribute	Osztály	Egy beállításcsoport leíró tesztje, amelyet elsősorban futásidejű és tervezési idejű eszközök használnak.
SettingsManageabilityAttribute	Mindkettő	Nulla vagy több kezelhetőségi szolgáltatást határoz meg, amelyeket a beállításcsoportnak vagy tulajdonságnak kell nyújtania. Az elérhető szolgáltatásokat a SettingsManageability enumerálás ismerteti.
SpecialSettingAttribute	Ingatlan	Azt jelzi, hogy egy beállítás egy speciális, előre definiált kategóriához tartozik, például egy kapcsolati sztringhez, amely a beállításszolgáltató speciális feldolgozását javasolja. Az attribútum előre definiált kategóriáit a SpecialSetting enumerálás határozza meg.
SettingsSerializeAsAttribute	Mindkettő	Egy beállításcsoport vagy tulajdonság előnyben részesített szerializálási mechanizmusát adja meg. A rendelkezésre álló szerializálási mechanizmusokat a SettingsSerializeAs enumerálás határozza meg.
NoSettingsVersionUpgradeAttribute	Ingatlan	Megadja, hogy egy beállításszolgáltató letiltsa a megjelölt tulajdonság összes alkalmazásfrissítési funkcióját.

osztály azt jelzi, hogy az attribútum csak egy alkalmazásbeállítások burkolóosztályára alkalmazható. tulajdonság azt jelzi, hogy az attribútum csak a beállítások tulajdonságait alkalmazhatja. Mindkét azt jelzi, hogy az attribútum mindkét szinten alkalmazható.

Lásd még

• ApplicationSettingsBase
• SettingsProvider
• alkalmazásbeállítások architektúrája
• Útmutató: Alkalmazásbeállítások létrehozása