Atrybuty ustawień aplikacji

  • Artykuł

Architektura aplikacji Ustawienia zawiera wiele atrybutów, które można zastosować do klasy otoki ustawień aplikacji lub jej poszczególnych właściwości. Te atrybuty są analizowane w czasie wykonywania przez infrastrukturę ustawień aplikacji, często w szczególności dostawcę ustawień, aby dostosować jego funkcjonowanie do określonych potrzeb niestandardowej otoki.

W poniższej tabeli wymieniono atrybuty, które można zastosować do klasy otoki ustawień aplikacji, poszczególnych właściwości tej klasy lub obu tych właściwości. Z definicji do każdej właściwości ustawień należy zastosować tylko jeden atrybut zakresu — UserScopedSettingAttribute lub ApplicationScopedSettingAttribute.

Uwaga

Dostawca ustawień niestandardowych pochodzący z SettingsProvider klasy jest wymagany tylko do rozpoznawania następujących trzech atrybutów: ApplicationScopedSettingAttribute, UserScopedSettingAttribute i DefaultSettingValueAttribute.

Atrybut Cel opis
SettingsProviderAttribute Oba Określa krótką nazwę dostawcy ustawień do użycia na potrzeby trwałości.

Jeśli ten atrybut nie zostanie podany, przyjmuje się, że domyślny dostawca , LocalFileSettingsProvider.
UserScopedSettingAttribute Oba Definiuje właściwość jako ustawienie aplikacji o zakresie użytkownika.
ApplicationScopedSettingAttribute Oba Definiuje właściwość jako ustawienie aplikacji o zakresie aplikacji.
DefaultSettingValueAttribute Właściwości Określa ciąg, który może być deserializowany przez dostawcę do trwale zakodowanej wartości domyślnej dla tej właściwości.

Atrybut LocalFileSettingsProvider nie wymaga tego atrybutu i zastąpi dowolną wartość podaną przez ten atrybut, jeśli istnieje już utrwalone wartości.
SettingsDescriptionAttribute Właściwości Udostępnia opisowy test dla poszczególnych ustawień, używany głównie przez narzędzia w czasie wykonywania i czasie projektowania.
SettingsGroupNameAttribute Klasa Zawiera jawną nazwę grupy ustawień. Jeśli brakuje tego atrybutu, ApplicationSettingsBase użyj nazwy klasy otoki.
SettingsGroupDescriptionAttribute Klasa Udostępnia opisowy test grupy ustawień używany głównie przez narzędzia czasu wykonywania i czasu projektowania.
SettingsManageabilityAttribute Oba Określa zero lub więcej usług zarządzania, które mają być udostępniane grupie lub właściwości ustawień. Dostępne usługi są opisane w wyliczeniem SettingsManageability .
SpecialSettingAttribute Właściwości Wskazuje, że ustawienie należy do specjalnej, wstępnie zdefiniowanej kategorii, takiej jak parametry połączenia, która sugeruje specjalne przetwarzanie przez dostawcę ustawień. Wstępnie zdefiniowane kategorie dla tego atrybutu SpecialSetting są definiowane przez wyliczenie.
SettingsSerializeAsAttribute Oba Określa preferowany mechanizm serializacji dla grupy ustawień lub właściwości. Dostępne mechanizmy serializacji są definiowane przez SettingsSerializeAs wyliczenie.
NoSettingsVersionUpgradeAttribute Właściwości Określa, że dostawca ustawień powinien wyłączyć wszystkie funkcje uaktualniania aplikacji dla oznaczonej właściwości.

Klasa wskazuje, że atrybut można zastosować tylko do klasy otoki ustawień aplikacji. Właściwość wskazuje, że atrybut można zastosować tylko właściwości ustawień. Oba wskazują, że atrybut można zastosować na każdym poziomie.

Zobacz też