Gerenciando definições de aplicativo
As configurações de aplicativo permitem que você armazene dinamicamente informações do aplicativo.As configurações permitem que você armazene informações no computador cliente que não devem ser incluídos no código do aplicativo (por exemplo uma cadeia de conexão), em preferências do usuário e em outras informações que você precisa em tempo de execução.
As configurações do aplicativo substituem as propriedades dinâmicas usadas em versões anteriores do Visual Studio.
Cada configuração de aplicativo deve ter um nome exclusivo.O nome pode ser qualquer combinação de letras, números ou um sublinhado que não inicia com um número, e não pode conter espaços.O nome pode ser alterado através da propriedade Name.
Configurações do aplicativo podem ser armazenadas como qualquer tipo de dados XML que podem ser serializados, ou tem um TypeConverter que implementa ToString/FromString.Os tipos mais comuns são String, Integer e Boolean, mas você também pode armazenar valores como Color, Object ou como uma cadeia de conexão.
Configurações do aplicativo também contém um valor.O valor é definido com a propriedade Valor e deve corresponder ao tipo de dados da configuração.
Além disso, as configurações do aplicativo podem ser associadas a uma propriedade de um formulário ou controle em tempo de design.
Há dois tipos de configurações do aplicativo, com base no escopo:
Configurações no escopo do aplicativo podem ser usadas para informações como a URL de um serviço Web ou uma cadeia de conexão de banco de dados.Esses valores são associados com o aplicativo.Portanto, os usuários não podem alterá-los em tempo de execução.
Configurações no escopo do usuário podem ser usadas para obter informações, como aceitar a última posição de um formulário ou uma preferência da fonte.Os usuários podem alterar esses valores em tempo de execução.
Você pode alterar o tipo de uma configuração usando a propriedade Escopo.
O sistema do projeto armazena configurações do aplicativo em dois arquivos XML: um arquivo app.config, que é criado em tempo de design quando você cria a primeira configuração do aplicativo; e um arquivo User.config, que é criado em tempo de execução quando o usuário que executa o aplicativo altera o valor de qualquer configuração do usuário.Observe que as alterações nas Configurações de Usuário não são gravadas em disco, a menos que o aplicativo chame um método para fazer isso especificamente.
Criando definições de aplicativo em tempo de design
Em tempo de design, você pode criar configurações de aplicativo de duas maneiras: usando o configurações página o Project Designer, ou usando o propriedades janela para um formulário ou controle, que permite associar uma configuração a uma propriedade.
Quando você cria uma configuração no escopo do aplicativo( por exemplo, uma cadeia de conexão de banco de dados ou uma referência a recursos de servidor), o Visual Studio salva essas informações no arquivo app.config com a guia <applicationSettings>.(As cadeias de conexão são salvas sob a marca <connectionStrings>.)
Quando você cria uma definição de escopo do usuário (por exemplo, fonte padrão, página inicial ou o tamanho da janela), Visual Studio o salva no app.config com a marca <userSettings>.
.gif "Observação de segurança") Observação de segurança |
|---|
Quando você armazena cadeias de conexão em app.config, deve tomar precauções para evitar revelar informações sigilosas, como senhas ou caminhos de servidor, na cadeia de conexão. Se você extrair informações de cadeia de conexão de uma fonte externa, como um usuário que fornece um ID de usuário e uma senha, deverá ser cuidadoso para assegurar que os valores usados para construir a cadeia de conexão não contêm parâmetros adicionais de cadeia de conexão que alteram o comportamento da conexão. Considere a possibilidade de usar o recurso protegido de configuração para criptografar informações sigilosas em um arquivo de configuração.Consulte Protegendo informações de conexão para obter mais informações. |
.gif "Observação") Observação |
|---|
Como não há nenhum modelo arquivo de configuração para bibliotecas de classes, configurações do aplicativo não se aplicam para projetos de biblioteca de classes.A exceção é um projeto Visual Studio Tools for Office DLL, que pode ter um arquivo de configuração. |
Usando Arquivos de Configurações Personalizadas
Você pode adicionar arquivos de configurações personalizadas ao seu projeto para o gerenciamento conveniente de grupos de configurações.As configurações contidas em um único arquivo são carregadas e salvas como uma unidade.Portanto, poder armazenar as configurações em arquivos separados para grupos usados com frequência e pouco usados pode economizar tempo em carregar e salvar as configurações.
Por exemplo, você pode adicionar um arquivo, como SpecialSettings.Settings ao seu projeto.Enquanto a classe SpecialSettings não for exposta no My namespace, Exibir código pode ler o arquivo de configurações personalizadas que contém Partial Class SpecialSettings.
O designer de configurações primeiro procura o arquivo Settings.Settings que cria o sistema do projeto; esse é o arquivo padrão que exibe o criador do projeto na guia Configurações.Settings.Settings está localizado na pasta Meu projeto para projetos Visual Basic e na pasta Propriedades para projetos Visual C#.O Designer de Projeto, em seguida, procura por outros arquivos de configurações na pasta raiz do projeto.Portanto, você deve colocar seu arquivo de configurações personalizado lá.Se você adicionar um arquivo .settings em qualquer lugar no seu projeto, o designer de projeto não poderá localizá-lo.
Acessar ou alterar configurações do aplicativo em tempo de execução em Visual Basic
Em projetos Visual Basic , você pode acessar as configurações do aplicativo no tempo de execução usando o objeto My.Settings.Na página Configurações, clique no botão Exibir código para exibir o arquivo Settings.vb.Settings.vb define a classe Settings, que permite que você manipule esses eventos na classe de configurações: SettingChanging, PropertyChanged, SettingsLoaded e SettingsSaving.Observe que a classe Settings em Settings.vb é um classe parcial que exibe somente o código de propriedade do usuário, não a classe gerada toda.Para obter mais informações sobre como acessar configurações do aplicativo usando o My.Settings de objeto, consulte Acessando configurações de aplicativo (Visual Basic).
Os valores de qualquer configuração de escopo do usuário que o usuário altera em tempo de execução (por exemplo, a posição de um formulário) são armazenados em um arquivo User.config.Observe que os valores padrão ainda são salvos no app.config.
Se você tiver alterado quaisquer configurações de escopo do usuário durante o tempo de execução, por exemplo no teste do aplicativo e deseja redefinir essas configurações para seus valores padrão, clique o sincronizar botão.
É altamente recomendável que você use o objeto My.Settings e o arquivo .Settings padrão para as configurações de acesso.Isso ocorre porque você pode usar o criador configurações para atribuir propriedades para Configurações, e, além disso, Configurações de Usuário são automaticamente salvas antes do desligamento do aplicativo.No entanto, seu aplicativo Visual Basic pode acessar as configurações diretamente.Nesse caso você precisa acessar a classe MySettings e usar um arquivo personalizado .settings na raiz do projeto.Você também deve salvar as configurações de usuário antes de encerrar o aplicativo, como você faria para um aplicativo C#; isso é descrito na seção a seguir.
Acessar ou alterar configurações do aplicativo em tempo de execução em Visual C#
Em linguagens diferentes de Visual Basic, como Visual C#, você deve acessar a classe Settings diretamente, como mostrado no exemplo de Visual C# a seguir.
Properties.Settings.Default.FirstUserSetting = "abc";
Você deve também explicitamente chamar o método Save desta classe wrapper para manter as Configurações de Usuário.Geralmente, você faz isso no manipulador de eventos Closing do formulário principal.O exemplo a seguir Visual C# mostra como chamar o método Save.
Properties.Settings.Default.Save();
Para obter um exemplo específico de como criar novas configurações do aplicativo e associá-las a propriedades em um formulário, consulte Como criar configurações do aplicativo usando o designer.Para obter mais informações sobre como acessar as configurações do aplicativo de Settings classe, consulte Visão geral sobre configurações do aplicativo.Para obter informações sobre a iteração por meio das configurações, consulte postagem no fórum.