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 precedenti impostazioni con ambito di 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 dell'applicazione corrente.
- properties
- SettingsPropertyCollection
Classe SettingsPropertyCollection contenente il gruppo di proprietà delle impostazioni di cui è necessario recuperare i valori.
Implementazioni
Eccezioni
È stata rilevata un'impostazione con ambito di utente, ma la configurazione corrente supporta solo le impostazioni con ambito di applicazione.
-oppure-
Non è possibile accedere alla versione precedente del file di configurazione.
Commenti
LocalFileSettingsProvider esegue la migrazione delle impostazioni locali e roaming nelle operazioni separate.
Il Upgrade metodo viene eliminato per ogni impostazione dell'applicazione applicata NoSettingsVersionUpgradeAttribute o all'intera classe wrapper delle impostazioni, derivata da ApplicationSettingsBase.
In questo modo questo metodo viene chiamato dipende dal tipo di applicazione che viene aggiornata:
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 viene eseguita la nuova versione, la logica interna chiamerà Upgrade automaticamente per eseguire la migrazione di tutte le impostazioni dell'applicazione comuni alla nuova versione. Per altre informazioni, vedere Impostazioni dell'applicazione e ClickOnce.
Le applicazioni standard Windows Forms e console devono chiamare Upgrademanualmente , 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 simile
IsFirstRuna .
Si noti che per la versione più recente per 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 sia con le nuove che con le versioni precedenti dell'applicazione.
