Partilhar via

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, em seguida, 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 ficheiro 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 seguinte XML dentro do <configuration> elemento .

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

Acesse a configuração programaticamente

Para aceder ao valor da configuração no seu código, obtenha o valor indexando na propriedade AppSettings. A AppSettings propriedade facilita a obtenção de dados do <appSettings> elemento 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 definições de configuração da mesma forma que os aplicativos executáveis, no entanto, as definições de configuração devem existir no arquivo App.config do aplicativo cliente. Mesmo que você distribua um arquivo App.config ao lado do arquivo assembly da biblioteca, o código da biblioteca não lerá o arquivo. Como alternativa, considere as seguintes maneiras de usar definições de configuração em uma biblioteca de classes:

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

Ver também