O ClickOnce e configurações do aplicativo
As configurações do aplicativo para Windows Forms torna fácil criar, armazenar e manter aplicativos personalizados e preferências do usuário no cliente.Este documento descreve como os arquivos de configurações de aplicativo funcionam em um aplicativo ClickOnce e como ClickOnce migra as configurações quando o usuário para a próxima versão.
As informações abaixo se aplicam somente ao provedor de configurações de aplicativo padrão, a LocalFileSettingsProvider classe. Se você fornecer um provedor personalizado, esse provedor determinará armazena seus dados e como ele atualizações suas configurações entre versões.Para obter mais informações sobre provedores de configurações de aplicativo, consulte Arquitetura das Configurações do Aplicativo.
Arquivos de configurações do aplicativo
As configurações do aplicativo consome dois arquivos: aplicativo. exe.config e usuário.config, onde aplicativo é o nome do seu aplicativo Windows Forms.User.config é criado como o horário do cliente primeiro que o aplicativo armazena configurações no escopo do usuário.aplicativo. exe.config, por outro lado, existirá antes para implantação se você definir valores padrão para as configurações.O Visual Studio incluirá esse arquivo automaticamente quando você usa o seu Publicarcomando .Se você criar seu aplicativo ClickOnce usando o Mage.exe ou MageUI.exe, você deve verificar esse arquivo é incluído no seu aplicativo manifesto de outros arquivos ao popular seu aplicativo.
Em um aplicativos do Windows Forms não implantados usando ClickOnce, aplicativo. exe.config arquivo é armazenado no diretório do aplicativo, enquanto o arquivo user.config é armazenado no Documents and Settings pasta.Em um aplicativo ClickOnce, aplicativo. exe.config reside no diretório de aplicativo dentro de cache do aplicativo ClickOnce e usuário.config reside no diretório de dados ClickOnce para o aplicativo.
Independentemente de como implantar seu aplicativo, as configurações de aplicativo garante o acesso de leitura seguro a aplicativo. exe.config e acesso de leitura/gravar segura ao usuário.config.
Em um aplicativo ClickOnce, o dimensionar dos arquivos de configuração usado por configurações de aplicativo é restrito pelo dimensionar do cache do ClickOnce.Para obter mais informações, consulte Visão geral do cache do ClickOnce.
Atualizações de versão
Assim sistema autônomo cada versão de um aplicativo ClickOnce é isolado de todas sistema autônomo outras versões, sistema autônomo configurações de aplicativo para um aplicativo ClickOnce são isoladas entre sistema autônomo configurações para outras versões também.Quando suas atualizações de usuário para uma versão posterior do seu aplicativo, as configurações do aplicativo compara as configurações do versão mais recente (mais alta numeradas) com as configurações fornecidos com a versão atualizada e mescla as configurações em um novo conjunto de arquivos de configurações.
A tabela a seguir descreve como as configurações do aplicativo decide quais configurações para copiar.
Tipo de alterar |
Atualizar ação |
|---|---|
Configuração adicionada ao aplicativo. exe.config |
A nova configuração é mesclada no versão corrente's aplicativo. exe.config |
Configuração removida aplicativo. exe.config |
A configuração antiga é removida do versão corrente's aplicativo. exe.config |
Padrão da configuração alterado; configuração local ainda conjunto como padrão original no usuário.config |
A configuração é mesclada no usuário.config versão corrente'sistema autônomo com o novo padrão sistema autônomo o valor |
Alterar padrão da configuração; configuração definida como não-padrão usuário.config |
A configuração é mesclada no usuário.config versão corrente's com o valor não-padrão retido |
Se você tiver criado suas próprias configurações de aplicativo de classe wrapper e quiser personalizar a lógica de atualização, você pode substituir o Upgrade método.
O ClickOnce e configurações de roaming
ClickOnce não funciona com as configurações roaming, que permite que o arquivo de configurações a seguir você em máquinas em uma rede.Se você precisar de configurações de roaming, será necessário implementar um provedor de configurações de aplicativo que armazena configurações através da rede ou desenvolver suas próprias classes de configurações personalizadas para armazenar configurações em um computador remoto.Para obter mais informações em provedores de configurações, consulte Arquitetura das Configurações do Aplicativo.
Consulte também
Conceitos
Visão geral sobre a implantação do ClickOnce
Visão Geral Sobre Configurações do Aplicativo