IApplicationSettingsProvider.Upgrade Metodo

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

IApplicationSettingsProvider.cs

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 -> unit

Public 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.

Vedi anche

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Upgrade()
• NoSettingsVersionUpgradeAttribute
• Esecuzione side-by-side