Compartilhar via

Configurar aplicativos usando arquivos de configuração

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.

O .NET Framework oferece aos desenvolvedores e administradores controle e flexibilidade sobre a maneira como os aplicativos são executados por meio de arquivos de configuração. Os arquivos de configuração são arquivos XML que podem ser alterados conforme necessário. Um administrador pode controlar quais recursos protegidos um aplicativo pode acessar, quais versões de assemblies um aplicativo usará e onde aplicativos e objetos remotos estão localizados. Os desenvolvedores podem colocar configurações em arquivos de configuração, eliminando a necessidade de recompilar um aplicativo sempre que uma configuração for alterada. Esta seção descreve o que pode ser configurado e por que configurar um aplicativo pode ser útil.

Observação

O código gerenciado pode usar as classes no System.Configuration namespace para ler as configurações dos arquivos de configuração, mas não para gravar configurações nesses arquivos.

Este artigo descreve a sintaxe dos arquivos de configuração e fornece informações sobre os três tipos de arquivos de configuração: computador, aplicativo e segurança.

Formato de arquivo de configuração

Os arquivos de configuração contêm elementos, que são estruturas de dados lógicas que definem informações de configuração. Em um arquivo de configuração, você usa marcas para marcar o início e o fim de um elemento. Por exemplo, o elemento <runtime> consiste em <runtime>elementos filho</runtime>. Um elemento vazio seria escrito como <runtime/> ou <runtime></runtime>.

Como com todos os arquivos XML, a sintaxe em arquivos de configuração diferencia maiúsculas de minúsculas.

Especifique as configurações usando atributos definidos, que são pares nome/valor dentro da tag de início de um elemento. O exemplo a seguir especifica dois atributos (version e href) para o <codeBase> elemento, que especifica onde o runtime pode localizar um assembly (para obter mais informações, consulte Especificando a localização de um assembly).

<codeBase version="2.0.0.0"
          href="http://www.litwareinc.com/myAssembly.dll"/>

Arquivos de configuração do computador

O arquivo de configuração do computador,Machine.config, contém configurações que se aplicam a um computador inteiro. Esse arquivo está localizado no caminho de instalação do runtime % diretório%\Config. Machine.config contém definições de configuração para vinculação de assembly em toda a máquina, canais remotos integrados e o ASP.NET.

O sistema de configuração examina primeiro o arquivo de configuração do computador para o <elemento appSettings e outras> seções de configuração que um desenvolvedor pode definir. Em seguida, ele examina o arquivo de configuração do aplicativo. Para manter o arquivo de configuração do computador gerenciável, é melhor colocar essas configurações no arquivo de configuração do aplicativo. No entanto, colocar as configurações no arquivo de configuração do computador pode tornar seu sistema mais mantenedível. Por exemplo, se você tiver um componente de terceiros que seu aplicativo cliente e servidor usa, será mais fácil colocar as configurações desse componente em um só lugar. Nesse caso, o arquivo de configuração do computador é o local apropriado para as configurações, portanto, você não tem as mesmas configurações em dois arquivos diferentes.

Observação

A implantação de um aplicativo usando XCOPY não copiará as configurações no arquivo de configuração do computador.

Para obter mais informações de como o Common Language Runtime usa o arquivo de configuração do computador para a associação de assembly, consulte Como o tempo de execução localiza assemblies.

Arquivos de configuração do aplicativo

Um arquivo de configuração de aplicativo contém configurações específicas para um aplicativo. Esse arquivo inclui configurações que o Common Language Runtime lê (como política de associação de assembly, objetos remotos e assim por diante), além das configurações que o aplicativo pode ler.

O nome e o local do arquivo de configuração do aplicativo dependem do host do aplicativo, que pode ser um dos seguintes:

  • Aplicativo hospedado em executável.

    Esses aplicativos têm dois arquivos de configuração: um arquivo de configuração de origem, que é modificado pelo desenvolvedor durante o desenvolvimento, e um arquivo de saída distribuído com o aplicativo.

    Por padrão, o nome do arquivo de configuração de origem é App.config. Quando você cria um projeto do .NET Framework no Visual Studio, um arquivo App.config é adicionado automaticamente ao projeto. Você também pode adicionar um arquivo manualmente selecionando Arquivo>Novo Arquivo. Coloque o arquivo App.config no diretório do projeto e defina sua propriedade Copy To Output Directory como Copiar sempre ou Copiar se for mais recente.

    Para criar o arquivo de configuração de saída implantado com o aplicativo, o Visual Studio copia o arquivo de configuração de origem para o diretório em que o assembly compilado é colocado. Esse arquivo é chamado <de nome de aplicativo>.exe.config. Por exemplo, um aplicativo chamado myApp.exe tem um arquivo de configuração de saída chamado myApp.exe.config.

    Em alguns casos, o Visual Studio pode modificar o arquivo de configuração de saída. Para obter mais informações, consulte Redirecionar versões no nível do aplicativo.

  • Aplicativo hospedado em ASP.NET.

    Para obter mais informações sobre ASP.NET arquivos de configuração, consulte ASP.NET Configurações.

Arquivos de configuração de segurança

Os arquivos de configuração de segurança contêm informações sobre a hierarquia do grupo de códigos e conjuntos de permissões associados a um nível de política. É altamente recomendável que você use a ferramenta política de segurança de acesso de código (Caspol.exe) para modificar a política de segurança para garantir que as alterações de política não corrompam os arquivos de configuração de segurança.

Observação

A partir do .NET Framework 4, os arquivos de configuração de segurança só estarão presentes se a política de segurança tiver sido alterada.

Os arquivos de configuração de segurança estão nos seguintes locais:

  • Arquivo de configuração de política empresarial: %runtime-install-path%\Config\Enterprisesec.config

  • Arquivo de configuração de política do computador: %runtime-install-path%\Config\Security.config

  • Arquivo de configuração de política de usuário: %USERPROFILE%\Dados do aplicativo\Microsoft\CLR security config\vxx.xx\Security.config

Consulte também