IApplicationSettingsProvider.Upgrade Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Indica ao provedor que o aplicativo foi atualizado. Isso oferece ao provedor uma oportunidade de atualizar suas 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 -> unitPublic Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)Parâmetros
- context
- SettingsContext
Uma SettingsContext descrição do uso atual do aplicativo.
- 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 a 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 GetPreviousVersion método para migrar as 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 tenha o NoSettingsVersionUpgradeAttribute aplicativo aplicado a ele ou para a classe wrapper de configurações inteira, derivada de ApplicationSettingsBase.
