Como ler configurações do aplicativo
Observação
Este artigo é específico para aplicativos .NET Framework. 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 documentos ConfigurationManager.
Adicionar o arquivo de configuração do aplicativo
O Visual Studio facilita a adição de um arquivo App.config ao projeto. Depois de criar um projeto .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 no elemento <configuration>.
<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-o na propriedade AppSettings. A propriedade AppSettings facilita a obtenção de dados do elemento <appSettings> do 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, porém, as configurações devem existir no arquivo App.config do aplicativo cliente. Mesmo que você distribua um arquivo App.config juntamente 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 que você está instanciando na biblioteca de classes.
- Implemente um tipo de seção personalizado que estende a classe ConfigurationSection. 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 do arquivo de configuração do aplicativo cliente. Para obter mais informações, consulte Como criar seções de configuração personalizadas usando ConfigurationSection.
