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. Questo offre al provider l'opportunità di aggiornare le impostazioni archiviate in base alle esigenze.
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 corrente dell'applicazione.
- properties
- SettingsPropertyCollection
Oggetto SettingsPropertyCollection contenente il gruppo di proprietà delle impostazioni i cui valori devono essere recuperati.
Commenti
Il framework di .NET 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 NoSettingsVersionUpgradeAttribute cui è applicato o all'intera classe wrapper delle impostazioni, derivata da ApplicationSettingsBase.
