Share via

Attributi delle impostazioni delle applicazioni

  • Articolo

L'architettura application Impostazioni fornisce molti attributi che possono essere applicati alla classe wrapper delle impostazioni delle applicazioni o alle relative singole proprietà. Questi attributi vengono esaminati in fase di esecuzione dall'infrastruttura delle impostazioni dell'applicazione, spesso specificamente il provider di impostazioni, per adattarne il funzionamento alle esigenze indicate del wrapper personalizzato.

Nella tabella seguente sono elencati gli attributi che possono essere applicati alla classe wrapper delle impostazioni dell'applicazione, alle singole proprietà di questa classe o a entrambe. Per definizione, è necessario applicare solo un singolo attributo di ambito, UserScopedSettingAttribute o ApplicationScopedSettingAttribute, a ogni proprietà delle impostazioni.

Nota

Un provider di impostazioni personalizzato, derivato dalla SettingsProvider classe , è necessario solo per riconoscere i tre attributi seguenti: ApplicationScopedSettingAttribute, UserScopedSettingAttribute e DefaultSettingValueAttribute.

Attributo Destinazione Descrizione
SettingsProviderAttribute Entrambe Specifica il nome breve del provider di impostazioni da usare per la persistenza.

Se questo attributo non viene fornito, viene utilizzato il provider predefinito , LocalFileSettingsProvider.
UserScopedSettingAttribute Entrambe Definisce una proprietà come impostazione dell'applicazione con ambito utente.
ApplicationScopedSettingAttribute Entrambe Definisce una proprietà come impostazione dell'applicazione con ambito applicazione.
DefaultSettingValueAttribute Proprietà Specifica una stringa che può essere deserializzata dal provider nel valore predefinito hardcoded per questa proprietà.

Non LocalFileSettingsProvider richiede questo attributo e sostituirà qualsiasi valore fornito da questo attributo se è già persistente un valore.
SettingsDescriptionAttribute Proprietà Fornisce il test descrittivo per una singola impostazione, usato principalmente dagli strumenti in fase di esecuzione e in fase di progettazione.
SettingsGroupNameAttribute Classe Fornisce un nome esplicito per un gruppo di impostazioni. Se questo attributo non è presente, ApplicationSettingsBase usa il nome della classe wrapper.
SettingsGroupDescriptionAttribute Classe Fornisce il test descrittivo per un gruppo di impostazioni, usato principalmente dagli strumenti in fase di esecuzione e progettazione.
SettingsManageabilityAttribute Entrambe Specifica zero o più servizi di gestibilità che devono essere forniti al gruppo o alla proprietà delle impostazioni. I servizi disponibili sono descritti dall'enumerazione SettingsManageability .
SpecialSettingAttribute Proprietà Indica che un'impostazione appartiene a una categoria speciale predefinita, ad esempio un stringa di connessione, che suggerisce un'elaborazione speciale da parte del provider di impostazioni. Le categorie predefinite per questo attributo sono definite dall'enumerazione SpecialSetting .
SettingsSerializeAsAttribute Entrambe Specifica un meccanismo di serializzazione preferito per un gruppo di impostazioni o una proprietà. I meccanismi di serializzazione disponibili sono definiti dall'enumerazione SettingsSerializeAs .
NoSettingsVersionUpgradeAttribute Proprietà Specifica che un provider di impostazioni deve disabilitare tutte le funzionalità di aggiornamento dell'applicazione per la proprietà contrassegnata.

La classe indica che l'attributo può essere applicato solo a una classe wrapper delle impostazioni dell'applicazione. La proprietà indica che l'attributo può essere applicato solo alle proprietà delle impostazioni. Entrambi indicano che l'attributo può essere applicato a entrambi i livelli.

Vedi anche