LocalFileSettingsProvider.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.
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 -> 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.
Implementações
Exceções
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.
