Como ler as configurações do aplicativo

Observação

Este artigo é específico do .NET Framework. Ele não se aplica a implementações mais recentes do .NET, incluindo o .NET 6 e versões posteriores.

Este artigo mostra como adicionar uma configuração simples a um arquivo App.config em um aplicativo .NET Framework e ler o valor programaticamente. Em vez de apenas ler um único valor, você pode ler uma seção inteira ou o arquivo inteiro. Para obter mais exemplos e informações, consulte os ConfigurationManager documentos.

Adicionar o arquivo App.config

O Visual Studio facilita a adição de um arquivo App.config ao seu projeto. Depois de criar um projeto do .NET Framework, clique com o botão direito do mouse em seu projeto no Gerenciador de Soluções e escolha Adicionar>Novo Item. Escolha o item Arquivo de Configuração do Aplicativo e, em seguida, selecione Adicionar.

Adicionar uma configuração

Abra o arquivo App.config e adicione o XML a seguir dentro do <configuration> elemento.

  <appSettings>
    <add key="occupation" value="dentist"/>
  </appSettings>

Acessar a configuração programaticamente

Para acessar o valor da configuração em seu código, obtenha o valor indexando na propriedade AppSettings. A propriedade AppSettings facilita a obtenção de dados do elemento <appSettings> do seu arquivo de configuração.

string occupation = ConfigurationManager.AppSettings["occupation"];

Configuração para bibliotecas

Embora seja simples usar arquivos de configuração para aplicativos executáveis, é um pouco mais complicado para bibliotecas de classes. As bibliotecas de classes podem acessar as configurações da mesma forma que os aplicativos executáveis, no entanto, as configurações devem existir no arquivo App.config do aplicativo cliente. Mesmo que você distribua um arquivo App.config junto com o arquivo de assembly da biblioteca, o código da biblioteca não lerá o arquivo. Como alternativa, considere as seguintes maneiras de usar as configurações em uma biblioteca de classes:

  • Obtenha as configurações no aplicativo cliente e passe-as para a classe da biblioteca de classes que você está instanciando.
  • Implemente um tipo de seção personalizado que estenda a ConfigurationSection classe. Mantenha um arquivo de configuração separado para sua biblioteca de classes e, em seguida, referencie o arquivo de configuração da biblioteca do arquivo de configuração do aplicativo cliente. Para obter mais informações, consulte Como criar seções de configuração personalizadas usando ConfigurationSection.

Consulte também

  • Last updated on