IApplicationSettingsProvider.Upgrade Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Indica ao fornecedor que a aplicação foi atualizada. Isto oferece ao fornecedor a oportunidade de atualizar as suas definiçõ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
A descreve a utilização atual da SettingsContext aplicação.
- properties
- SettingsPropertyCollection
A SettingsPropertyCollection contendo o grupo de propriedades settings cujos valores devem ser recuperados.
Observações
O .NET Framework permite a instalação e execução lado a lado de diferentes versões da mesma aplicação. O fornecedor de definições da aplicação armazena as definições da aplicação separadamente para garantir o isolamento. No entanto, pode querer migrar as definições da versão anterior de uma aplicação para a atual. Para fornecer esta funcionalidade de migração, use o Upgrade método, implementado numa classe derivada de SettingsProvider.
Pode usar o Upgrade método em conjunto com o GetPreviousVersion método para migrar as definições da aplicação durante ou após a instalação de uma nova versão da aplicação.
Este método deve ser suprimido para todas as definições de aplicação que tenham o NoSettingsVersionUpgradeAttribute é aplicado a ela, ou para toda a classe de wrapper de definições, derivada de ApplicationSettingsBase.
