LocalFileSettingsProvider.Upgrade Metodo
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.
Tenta di eseguire la migrazione delle impostazioni precedenti con ambito utente da una versione precedente della stessa applicazione.
public:
virtual void Upgrade(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyCollection ^ properties);public void Upgrade(System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyCollection properties);abstract member Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unit
override this.Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unitPublic Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)Parametri
- context
- SettingsContext
Oggetto SettingsContext che descrive l'utilizzo corrente dell'applicazione.
- properties
- SettingsPropertyCollection
Oggetto SettingsPropertyCollection contenente il gruppo di proprietà delle impostazioni i cui valori devono essere recuperati.
Implementazioni
Eccezioni
È stata rilevata un'impostazione con ambito utente, ma la configurazione corrente supporta solo le impostazioni con ambito applicazione.
oppure
Impossibile accedere alla versione precedente del file di configurazione.
Commenti
LocalFileSettingsProvider esegue la migrazione delle impostazioni locali e mobili in operazioni separate.
Il Upgrade metodo viene eliminato per ogni impostazione dell'applicazione a cui è NoSettingsVersionUpgradeAttribute applicato o all'intera classe wrapper delle impostazioni, derivata da ApplicationSettingsBase.
In questo modo questo metodo viene chiamato dipende dal tipo di applicazione da aggiornare:
Ogni versione di un'applicazione ClickOnce viene archiviata nella propria directory di installazione isolata. Dopo l'installazione di una nuova versione di un'applicazione ClickOnce e quando la nuova versione viene eseguita per la prima volta, la logica interna chiamerà Upgrade automaticamente per eseguire la migrazione di tutte le impostazioni comuni dell'applicazione alla nuova versione. Per altre informazioni, vedere ClickOnce e Impostazioni dell'applicazione.
Le applicazioni console e Windows Forms standard devono chiamare manualmente Upgrade, perché non esiste un modo generale e automatico per determinare quando tale applicazione viene eseguita per la prima volta. I due modi comuni per eseguire questa operazione sono dal programma di installazione o dall'applicazione stessa, usando una proprietà persistente, spesso denominata come
IsFirstRun.
Si noti che per la versione più recente di eseguire la migrazione delle impostazioni dell'applicazione, deve essere in grado di caricare e leggere anche la versione precedente delle impostazioni dell'applicazione. Pertanto, deve contenere classi wrapper compatibili con le versioni nuove e precedenti dell'applicazione.