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