LocalFileSettingsProvider.Upgrade Método

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

LocalFileSettingsProvider.cs

Tenta migrar configurações de escopo do usuário anteriores de uma versão anterior do mesmo aplicativo.

public:
 virtual 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
override this.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.

Implementações

Upgrade(SettingsContext, SettingsPropertyCollection)

Exceções

ConfigurationErrorsException

Foi encontrada uma configuração de escopo do usuário, mas a configuração atual dá suporte apenas a configurações de escopo do aplicativo.

- ou -

Não foi possível acessar a versão anterior do arquivo de configuração.

Comentários

LocalFileSettingsProvider migra as configurações locais e de roaming em operações separadas.

O Upgrade método é 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.

Dessa forma, esse método é chamado depende do tipo de aplicativo que está sendo atualizado:

• Cada versão de um aplicativo ClickOnce é armazenada em seu próprio diretório de instalação isolado. Depois que uma nova versão de um aplicativo ClickOnce for instalada e quando a nova versão for executada pela primeira vez, a lógica interna chamará Upgrade automaticamente para migrar todas as configurações comuns do aplicativo para a nova versão. Para obter mais informações, consulte ClickOnce e as configurações de aplicativo.

• Os aplicativos standard Windows Forms e de console devem chamar Upgrademanualmente , porque não há uma maneira geral e automática de determinar quando esse aplicativo é executado pela primeira vez. As duas maneiras comuns de fazer isso são do programa de instalação ou do próprio aplicativo, usando uma propriedade persistente, geralmente denominada algo como IsFirstRun.

Observe que, para que a versão mais recente migre as configurações do aplicativo, ela também deve ser capaz de carregar e ler a versão mais antiga das configurações do aplicativo. Portanto, ele deve conter classes wrapper compatíveis com as versões novas e anteriores do aplicativo.

Confira também

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Reset(SettingsContext)
• IApplicationSettingsProvider
• NoSettingsVersionUpgradeAttribute