ClickOnce e Configuraçõesdo aplicativo
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 de ClickOnce e como o ClickOnce migra as configurações quando o usuário atualizar para a próxima versão.
As informações a seguir se aplica somente para o provedor de configurações do aplicativo padrão, o LocalFileSettingsProvider classe. Se você fornecer um provedor personalizado, o provedor determinará como ela armazena seus dados e como ele atualiza suas configurações entre versões. Para obter mais informações sobre provedores de configurações do aplicativo, consulte Arquitetura das Configurações do Aplicativo.
Arquivos de configurações do aplicativo
Configurações do aplicativo consome dois arquivos: App. exe e User. config, onde aplicativo é o nome do seu aplicativo Windows Forms. User. config é criado na hora o cliente primeiro que o aplicativo armazena configurações de escopo do usuário. App. exe, por outro lado, existirá anteriores à implantação se você definir valores padrão para configurações. Visual Studio incluirá esse arquivo automaticamente quando você usa seu Publicar comando. Se você criar seu aplicativo de ClickOnce usando o Mage ou MageUI.exe, você deve certificar-se este arquivo é incluído em seu aplicativo de outros arquivos quando você preencher seu manifesto de aplicativo.
Em um aplicativos do Windows Forms não implantado usando o ClickOnce, um aplicativo aplicativo. exe é armazenado no diretório de aplicativo, enquanto o arquivo User. config é armazenado em que o usuário Documents and Settings pasta. Em um aplicativo de ClickOnce, aplicativo. exe reside no diretório de aplicativo dentro do cache do aplicativo ClickOnce, e o lives de User. config no diretório ClickOnce de dados para o aplicativo.
Independentemente de como você pode implantar seu aplicativo, configurações de aplicativo garante a seguro de acesso de leitura para aplicativo. exe e o acesso de leitura/gravação segura a User. config.
Em um aplicativo de ClickOnce, o tamanho dos arquivos de configuração usados pelas configurações do aplicativo é restrito pelo tamanho do cache de ClickOnce. Para obter mais informações, consulte ClickOnce Visão geral do cache.
Upgrades de versão
Assim como cada versão de um aplicativo de ClickOnce é isolado de todas as outras versões, as configurações do aplicativo para um aplicativo de ClickOnce são isoladas das configurações para outras versões também. Quando a usuário atualiza para uma versão posterior do seu aplicativo, compara de configurações do aplicativo configurações do versão mais recente (número mais alto) com as configurações fornecidos com a versão atualizada e mescla as configurações de 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 alteração |
Ação de atualização |
|---|---|
Configuração adicionada ao aplicativo. exe |
A nova configuração é mesclada na versão atual aplicativo. exe |
Configuração removida aplicativo. exe |
A configuração antiga é removida da versão atual aplicativo. exe |
Padrão de configuração alterado; configuração local ainda definido como o padrão original em User. config |
A configuração é mesclada ao User. config a da versão atual com o novo padrão como o valor |
Padrão de configuração alterado; configuração definida como não-padrão User. config |
A configuração é mesclada em User. config da versão atual com o valor não-padrão retido |
Se você tiver criado suas próprias configurações de aplicativo com classe de wrapper e quiser personalizar a lógica de atualização, você pode substituir o Upgrade método.
ClickOnce e as configurações de mobilidade
ClickOnce não funciona com configurações de roaming, que permite que o arquivo de configurações, execute as máquinas em uma rede. Se você precisar de configurações de roaming, você precisará implementar um provedor de configurações do aplicativo que armazena as 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
ClickOnce Segurança e implantação
Visão Geral Sobre Configurações do Aplicativo
ClickOnce Visão geral do cache
Acessando o Local e remoto a dados em aplicativos de ClickOnce