IApplicationSettingsProvider.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.
Indica al provider che l'applicazione è stata aggiornata, consentendo al provider di aggiornare le impostazioni archiviate in modo appropriato.
public:
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 -> 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.
Commenti
.NET Framework consente l'installazione side-by-side e l'esecuzione di versioni diverse della stessa applicazione. Il provider di impostazioni dell'applicazione archivia le impostazioni dell'applicazione per ogni versione di un'applicazione separatamente per garantire l'isolamento. Tuttavia, è possibile eseguire la migrazione delle impostazioni dalla versione precedente di un'applicazione a quella corrente. Per fornire questa funzionalità di migrazione, usare il Upgrade metodo , implementato in una classe derivata da SettingsProvider.
È possibile usare il Upgrade metodo insieme al GetPreviousVersion metodo per eseguire la migrazione delle impostazioni dell'applicazione durante o dopo l'installazione di una nuova versione di un'applicazione.
Questo metodo deve essere eliminato per ogni impostazione dell'applicazione a cui è applicato o NoSettingsVersionUpgradeAttribute all'intera classe wrapper delle impostazioni, derivata da ApplicationSettingsBase.
