Configurações de aplicativo

As configurações de aplicativo permitem a você armazenar e recuperar configurações de propriedade e outras informações para seu aplicativo dinamicamente.Eles também permitem que você mantenha aplicativos personalizados e preferências do usuário sobre o computador cliente.Geralmente isso são dados (como uma sequência de conexão) que é fundamental para a execução do aplicativo e que você não deseja incluir diretamente no código do aplicativo.Convém armazenar duas sequências diferentes de conexão a banco de dados e recuperar uma em tempo de execução com base no local do computador.Ou você talvez queira armazenar preferências de cor do usuário e, em seguida, recuperá-las na próxima vez que o aplicativo é executado.

Observe que as configurações do aplicativo são um Visual Studio recurso que substitui o recurso de propriedades dinâmicas nas versões anteriores (para obter informações sobre propriedades dinâmicas, consulte Configurando aplicativos usando propriedades dinâmicas.)

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 serializável 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 um sequência de conexão.

Configurações do aplicativo também contém um valor.O valor é definido com a propriedade Value e deve corresponder ao tipo de dados da configuração.

Além disso, configurações do aplicativo podem ser vinculadas a uma propriedade de um formulário ou controle em tempo de design.Para obter mais informações, consulte Como: Adicionar ou remover configurações do aplicativo.

Há dois tipos de configurações do aplicativo, com base no escopo:

• Configurações baseadas em escopo de uma aplicação podem ser usadas para informações como uma URL para um serviço Web ou uma sequência de conexão a base 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 Scope.

O sistema de projeto armazena as configurações do aplicativo em dois arquivos XML: um arquivo app.config, que é criado em time de design quando você cria a primeira configuração de aplicativo; e um arquivo user.config, que é criado em time de execução quando o usuário que executa o aplicativo altera o valor de qualquer configuração de usuário.Observe que as alterações no 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 time de design, você pode criar configurações de aplicativo de duas maneiras: usando o Configurações página de do Designer de projeto, ou usando o Propriedades janela para um formulário ou controle, que permite você BIND uma configuração a uma propriedade.Para obter mais informações, consulte Como: Adicionar ou remover configurações do aplicativo.

Quando você cria uma configuração de escopo de aplicação( por exemplo, uma sequência de conexão, ou uma referência a recursos de servidor), Visual Studio o salva no app.config com a aba <applicationSettings>.(Sequências de caracteres de conexão são salvos na marca <connectionStrings>.)

Quando você cria uma definição de escopo do usuário (por exemplo, fonte padrão, home page ou o tamanho da janela), Visual Studio salva-o no app.config com a marca <userSettings>.

Observação de segurança:

Quando você armazena sequências de caracteres de conexão em app.config, você deve tomar precauções para evitar revelar informações sigilosas, como senhas e caminhos de servidor, na sequência de conexão. Se você tirar informações de sequência de conexão de uma fonte externa, como um usuário fornecendo um ID de usuário e senha, você deve ser cuidadoso para garantir que os valores que você usa para construir sua sequência de conexão não contêm parâmetros adicionais de sequência 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 Proteger seqüências de caracteres de conexão Para obter mais informações.

Observação:
Porque 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 Visual Studio Tools for Microsoft Office DLL projeto, que pode ter uma configuração arquivo.

Usando arquivos de configurações Personalizada

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 seja exposta no My namespace, Exibir código pode ler o arquivo de configurações personalizadas que contenha 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 Settings.Settings.Settings está localizado na pasta Meu projeto para projetos Visual Basic e na pasta Propriedades para projetos Visual C#.O criador do 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 criador do 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 Settings,clique no botão Exibir código para exibir o arquivo Settings.vb.(Para obter mais informações, consulte Como: Eventos de configurações de acesso.) Settings.vb define o Settings classe permite manipular 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 de aplicativos usando o objeto My.Settings, consulte Acessando as configurações do aplicativo.

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 tempo de execução, por exemplo no teste do aplicativo e deseja redefinir essas configurações para seus valores padrão, clique no botão Synchronize.Para obter informações sobre esse controle, consulte Página de configurações, Designer de projeto..

É 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ê precise acessar a classe MySettings e usar um arquivo personalizado .Settings na raiz do projeto.Você também deve salvar a 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 Basic

Em idiomas diferentes do Visual Basic,como Visual C#,você deve acessar a classe Settings diretamente.

Você deve também explicitamente chamar o método Save esta classe wrapper para persistir as Configurações de Usuário.Geralmente isso é feito no manipulador de eventos Closing do formulário principal.Para obter um exemplo específico de como criar novas configurações do aplicativo e vinculá-los a propriedades em um formulário, consulte Como: Criar configurações do aplicativo usando o Designer.Para obter informações mais gerais sobre como acessar configurações do aplicativo por meio da classe Settings,consulte Visão Geral Sobre Configurações do Aplicativo.

Consulte também

Tarefas

Como: Adicionar ou remover configurações do aplicativo

Como: Eventos de configurações de acesso

Conceitos

Acessando as configurações do aplicativo

Referência

Página de configurações, Designer de projeto.

Outros recursos

Gerenciando definições de aplicativo