IApplicationSettingsProvider Interfaccia
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Definisce le funzionalità estese per i provider di impostazioni dell'applicazione client.
public interface class IApplicationSettingsProviderpublic interface IApplicationSettingsProvidertype IApplicationSettingsProvider = interfacePublic Interface IApplicationSettingsProvider- Derivato
Commenti
L'architettura delle impostazioni dell'applicazione consente di fornire un meccanismo di archiviazione personalizzato per le impostazioni dell'applicazione creando un provider di impostazioni personalizzato, che è una classe derivata da SettingsProvider. Tale classe contiene le funzionalità di base per l'archiviazione e il recupero delle proprietà. È tuttavia possibile aggiungere funzionalità standardizzate aggiuntive implementando l'interfaccia IApplicationSettingsProvider nel provider di impostazioni personalizzate. Questa interfaccia contiene tre metodi che consentono principalmente al provider di impostazioni di gestire in modo più intelligente le modifiche della versione dell'applicazione. In genere, il provider di impostazioni archivierà le impostazioni dell'applicazione per versioni diverse di un'applicazione separatamente per prevedere le circostanze seguenti:
Esecuzione side-by-side di versioni diverse di un'applicazione.
Conservazione delle impostazioni dell'applicazione durante l'aggiornamento di un'applicazione.
Reimpostando le impostazioni dell'applicazione sui valori predefiniti per la versione attualmente usata.
La classe LocalFileSettingsProvider implementa l'interfaccia IApplicationSettingsProvider. Lo stesso set di metodi contenuti in IApplicationSettingsProvider è disponibile anche nella ApplicationSettingsBase classe , consentendo la creazione di un canale di comunicazione predefinito tra un wrapper delle impostazioni dell'applicazione e il relativo provider di impostazioni.
Nota
Questa interfaccia è facoltativa. Se un provider non implementa questa interfaccia, l'infrastruttura delle impostazioni avrà esito negativo senza notifica se tenta di accedere a uno dei metodi definiti da questa interfaccia.
Metodi
| GetPreviousVersion(SettingsContext, SettingsProperty) |
Restituisce il valore della proprietà delle impostazioni specificata relativa alla versione precedente della stessa applicazione. |
| Reset(SettingsContext) |
Riconfigura le impostazioni associate all'applicazione specificata sui valori predefiniti. |
| Upgrade(SettingsContext, SettingsPropertyCollection) |
Indica al provider che l'applicazione è stata aggiornata, consentendo al provider di aggiornare le impostazioni archiviate in modo appropriato. |
