Attributi delle impostazioni delle applicazioni
L'architettura delle impostazioni delle applicazioni fornisce numerosi attributi che è possibile applicare alla classe wrapper delle impostazioni delle applicazioni o alle singole proprietà. Gli attributi vengono esaminati in fase di esecuzione dall'infrastruttura delle impostazioni delle applicazioni, spesso per l'esattezza dal provider di impostazioni, allo scopo di adattarne il funzionamento alle esigenze dichiarate del wrapper personalizzato.
Nella tabella seguente sono indicati gli attributi che è possibile applicare alla classe wrapper delle impostazioni dell'applicazione, alle singole proprietà della classe o a entrambi gli oggetti. Per definizione, è possibile applicare un solo attributo di ambito, UserScopedSettingAttribute o ApplicationScopedSettingAttribute, a ogni singola proprietà di impostazioni.
Nota
Un provider di impostazioni personalizzato, derivato dalla classe SettingsProvider, è necessario solo per riconoscere i tre attributi seguenti: ApplicationScopedSettingAttribute, UserScopedSettingAttribute e DefaultSettingValueAttribute.
Attributo |
Destinazione |
Descrizione |
|---|---|---|
Entrambi |
Specifica il nome breve del provider di impostazioni da utilizzare per la persistenza. Se l'attributo non è indicato, viene utilizzato il provider predefinito, LocalFileSettingsProvider. |
|
Entrambe |
Definisce una proprietà come impostazione dell'applicazione a livello di utente. |
|
Entrambe |
Definisce una proprietà come impostazione dell'applicazione a livello di applicazione. |
|
Proprietà |
Specifica una stringa che può essere deserializzata dal provider nel valore predefinito specificato a livello di codice (hard-coded) per la proprietà. La classe LocalFileSettingsProvider non richiede tale attributo e ignorerà qualsiasi valore da esso fornito se esiste già un valore persistente. |
|
Proprietà |
Fornisce il testo descrittivo di una singola impostazione, utilizzato essenzialmente da strumenti impiegati in fase di esecuzione e progettazione. |
|
Classe |
Fornisce un nome esplicito per un gruppo di impostazioni. Se tale attributo non è presente, la classe ApplicationSettingsBase utilizza il nome della classe wrapper. |
|
Classe |
Fornisce il testo descrittivo di un gruppo di impostazioni, utilizzato essenzialmente da strumenti impiegati in fase di esecuzione e progettazione. |
|
Entrambe |
Consente di specificare da zero a più servizi di gestibilità da fornire al gruppo di impostazioni o alla proprietà. I servizi disponibili sono descritti dall'enumerazione SettingsManageability. |
|
Proprietà |
Indica che un'impostazione appartiene a una categoria predefinita speciale, quale una stringa di connessione, che suggerisce l'elaborazione speciale da parte del provider di impostazioni. Le categorie predeterminate dell'attributo sono definite dall'enumerazione SpecialSetting. |
|
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. |
|
Proprietà |
Specifica che un provider di impostazioni deve disabilitare tutte le funzioni 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. Entrambe indica che l'attributo può essere applicato a entrambi i livelli.
Vedere anche
Attività
Procedura: creare le impostazioni delle applicazioni utilizzando la finestra di progettazione