Attributi delle impostazioni dell'applicazione
L'architettura delle impostazioni dell'applicazione 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, solo un singolo attributo di ambito,UserScopedSettingAttribute o ApplicationScopedSettingAttribute, deve essere applicato a ogni proprietà delle impostazioni.
Nota
Un provider di impostazioni personalizzato, derivato dalla classe SettingsProvider, è necessario solo per riconoscere i tre attributi seguenti: ApplicationScopedSettingAttribute, UserScopedSettingAttributee DefaultSettingValueAttribute.
| Attributo | Bersaglio | Descrizione |
|---|---|---|
| SettingsProviderAttribute | Entrambi | 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 | Entrambi | Definisce una proprietà come impostazione dell'applicazione a livello utente. |
| ApplicationScopedSettingAttribute | Entrambi | Definisce una proprietà come impostazione dell'applicazione con ambito a livello di applicazione. |
| DefaultSettingValueAttribute | Proprietà | Specifica una stringa che può essere deserializzata dal provider nel valore predefinito incorporato per questa proprietà. Il LocalFileSettingsProvider non richiede questo attributo e sostituirà qualsiasi valore fornito da questo attributo se esiste già un valore persistente. |
| SettingsDescriptionAttribute | Proprietà | Fornisce il test descrittivo per una singola impostazione, usato principalmente dagli strumenti di runtime e design-time. |
| 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 | Entrambi | Specifica zero o più servizi di gestione che devono essere forniti al gruppo di impostazioni o proprietà. I servizi disponibili sono descritti dall'enumerazione SettingsManageability. |
| SpecialSettingAttribute | Proprietà | Indica che un'impostazione appartiene a una categoria speciale predefinita, ad esempio una 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 | Entrambi | 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. |
Classe indica che l'attributo può essere applicato solo a una classe wrapper delle impostazioni dell'applicazione. Proprietà indica che l'attributo può essere applicato solo alle proprietà delle impostazioni. Entrambi i indicano che l'attributo può essere applicato a entrambi i livelli.
Vedere anche
.NET Desktop feedback