ApplicationSettingsBase.Upgrade Método

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

ApplicationSettingsBase.cs

Atualiza as configurações do aplicativo para refletir uma instalação mais recente do aplicativo.

public:
 virtual void Upgrade();

public virtual void Upgrade ();

abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unit

Public Overridable Sub Upgrade ()

Exceções

ConfigurationErrorsException

Não foi possível analisar o arquivo de configuração.

Comentários

O Upgrade método executa duas ações para garantir uma transição suave para uma nova versão de um aplicativo:

• Ele notifica todos os provedores de configurações correspondentes da existência do aplicativo atualizado por meio de uma chamada para seu IApplicationSettingsProvider.Upgrade método, supondo que eles tenham implementado a IApplicationSettingsProvider interface . Essa ação não será executada se a classe wrapper de configurações estiver marcada com NoSettingsVersionUpgradeAttribute.

• Ele recarrega os valores de todas as configurações do aplicativo.

Você pode substituir o comportamento padrão de para implementar o comportamento personalizado de Upgrade atualização ou mesclagem. Use o GetPreviousVersion método para recuperar valores individuais para uma configuração para a versão anterior do aplicativo. Exemplos de comportamento de atualização personalizado incluem:

• Usando novos padrões de política que substituem um ou mais dos valores especificados pelo usuário anterior ou padrões anteriores.

• Tradução especial de valores antigos para serem compatíveis com intervalos mais recentes, um grupo de propriedades de configurações diferente e assim por diante.

Confira também

• Providers
• Reload()
• GetPreviousVersion(String)
• NoSettingsVersionUpgradeAttribute
• Upgrade(SettingsContext, SettingsPropertyCollection)