IApplicationSettingsProvider.Upgrade Método

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

IApplicationSettingsProvider.cs

Indica ao provedor que o aplicativo foi atualizado. Isso oferece o provedor a oportunidade de atualizar as respectivas configurações armazenadas conforme apropriado.

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)

Parâmetros

context

SettingsContext

Um SettingsContext que descreve o uso do aplicativo atual.

properties

SettingsPropertyCollection

Um SettingsPropertyCollection que contém o grupo de propriedades de configurações cujos valores devem ser recuperados.

Comentários

O .NET Framework permite a instalação lado a lado e a execução de diferentes versões do mesmo aplicativo. O provedor de configurações de aplicativo armazena as configurações do aplicativo para cada versão de um aplicativo separadamente para garantir o isolamento. No entanto, talvez você queira migrar as configurações da versão anterior de um aplicativo para o atual. Para fornecer essa funcionalidade de migração, use o Upgrade método , implementado em uma classe derivada de SettingsProvider.

Você pode usar o Upgrade método em conjunto com o método para migrar as GetPreviousVersion configurações do aplicativo durante ou após a instalação de uma nova versão de um aplicativo.

Esse método deve ser suprimido para cada configuração de aplicativo que tem o NoSettingsVersionUpgradeAttribute é aplicado a ele ou para toda a classe wrapper de configurações, derivada de ApplicationSettingsBase.

Confira também

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Upgrade()
• NoSettingsVersionUpgradeAttribute
• Execução lado a lado