Partilhar via


IApplicationSettingsProvider.Upgrade Método

Definição

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.

Aplica-se a

Confira também