Partilhar via

Configure aplicativos usando ficheiros de configuração

  • Artigo

.NET Framework dá aos desenvolvedores e administradores controlo e flexibilidade sobre a forma como as aplicações são executadas através de ficheiros de configuração. Os ficheiros de configuração são ficheiros XML que podem ser alterados conforme necessário. Um administrador pode controlar quais os recursos protegidos a que uma aplicação pode aceder, quais as versões dos conjuntos que uma aplicação irá utilizar e onde estão localizadas aplicações e objetos remotos. Os desenvolvedores podem colocar definições em ficheiros de configuração, eliminando a necessidade de recompiler uma aplicação sempre que uma definição muda. Esta secção descreve o que pode ser configurado e por que configurar uma aplicação pode ser útil.

Nota

O código gerido pode utilizar as classes no espaço de System.Configuration nomes para ler as definições a partir dos ficheiros de configuração, mas não para escrever definições para esses ficheiros.

Este artigo descreve a sintaxe dos ficheiros de configuração e fornece informações sobre os três tipos de ficheiros de configuração: máquina, aplicação e segurança.

Formato de ficheiro de configuração

Os ficheiros de configuração contêm elementos, que são estruturas de dados lógicas que definem informações de configuração. Dentro de um ficheiro de configuração, utiliza-se tags para marcar o início e o fim de um elemento. Por exemplo, o <runtime> elemento consiste em elementos infantis</runtime><runtime>. Um elemento vazio seria escrito como <runtime/> ou .<runtime></runtime>

Tal como acontece com todos os ficheiros XML, a sintaxe nos ficheiros de configuração é sensível a casos.

Especifica as definições de configuração utilizando atributos predefinidos, que são pares de nome/valor dentro da etiqueta inicial de um elemento. O exemplo a seguir especifica dois atributos (version e href) para o <codeBase> elemento, que especifica onde o tempo de execução pode localizar um conjunto (para mais informações, ver Especificar a Localização de um Conjunto).

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

Ficheiros de configuração da máquina

O ficheiro de configuração da máquina,Machine.config, contém definições que se aplicam a um computador inteiro. Este ficheiro está localizado no percurso de instalação %\Config. Machine.config contém configurações de configuração para encadernação de montagem em toda a máquina, canais de remoagem incorporados e ASP.NET.

O sistema de configuração procura pela primeira vez no ficheiro de configuração da máquina para o <elemento de definição de appsSettings> e outras secções de configuração que um desenvolvedor pode definir. Em seguida, fica no ficheiro de configuração da aplicação. Para manter o ficheiro de configuração da máquina manejável, é melhor colocar estas definições no ficheiro de configuração da aplicação. No entanto, colocar as definições no ficheiro de configuração da máquina pode tornar o seu sistema mais mantido. Por exemplo, se tiver um componente de terceiros que a aplicação do seu cliente e do servidor utiliza, é mais fácil colocar as definições desse componente num só local. Neste caso, o ficheiro de configuração da máquina é o local apropriado para as definições, pelo que não tem as mesmas definições em dois ficheiros diferentes.

Nota

A implementação de uma aplicação utilizando o XCOPY não copiará as definições no ficheiro de configuração da máquina.

Para obter mais informações sobre como o tempo de execução da linguagem comum utiliza o ficheiro de configuração da máquina para a encadernação de montagem, consulte como o tempo de execução localiza conjuntos.

Ficheiros de configuração de aplicações

Um ficheiro de configuração de aplicação contém configurações específicas para uma aplicação. Este ficheiro inclui definições de configuração que o tempo de execução da linguagem comum lê (como a política de ligação de montagem, objetos de remoagem, e assim por diante), e as definições que a aplicação pode ler.

O nome e a localização do ficheiro de configuração da aplicação dependem do anfitrião da aplicação, o que pode ser um dos seguintes:

  • App executável.

    Estas aplicações têm dois ficheiros de configuração: um ficheiro de configuração de origem, que é modificado pelo desenvolvedor durante o desenvolvimento, e um ficheiro de saída que é distribuído com a app.

    Quando se desenvolver em Visual Studio, coloque o ficheiro de configuração de origem da sua aplicação no diretório do projeto e desave a propriedade copy To Output Directory para Copiar sempre ou Copiar se for mais recente. Por predefinição, o nome do ficheiro de configuração é App.config.

    Para criar o ficheiro de configuração de saída que é implementado com a app, Visual Studio cópias do ficheiro de configuração de origem para o diretório onde o conjunto compilado é colocado. Este ficheiro tem o nome <de seu nome> de nome.exe.config. Por exemplo, uma aplicação chamada myApp.exe terá um ficheiro de configuração de saída nomeado myApp.exe.config.

    Em alguns casos, Visual Studio podem modificar o ficheiro de configuração de saída; para obter mais informações, consulte as versões de montagem de redirecionamento na secção de nível de aplicação do artigo 'Versões de Montagem de Redirecionamento'.

  • ASP.NET-hosted app.

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

  • Aplicativo hospedado no Internet Explorer.

    Se uma aplicação hospedada no Internet Explorer tiver um ficheiro de configuração, a localização deste ficheiro é especificada numa <link> tag com a seguinte sintaxe: <link rel="*ConfigurationFileName*" href="*location*">

    Nesta etiqueta, location encontra-se um URL para o ficheiro de configuração. Isto define a base de aplicações. O ficheiro de configuração deve estar localizado no mesmo website que a aplicação.

Ficheiros de configuração de segurança

Os ficheiros de configuração de segurança contêm informações sobre a hierarquia do grupo de código e os conjuntos de permissões associados a um nível de política. Recomendamos vivamente que utilize a ferramenta Política de Segurança do Acesso ao Código (Caspol.exe) para modificar a política de segurança para garantir que as mudanças de política não corrompam os ficheiros de configuração de segurança.

Nota

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

Os ficheiros de configuração de segurança encontram-se nos seguintes locais:

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

  • Ficheiro de configuração da política da máquina: %%-runtime-install-path%\Config\Security.config

  • Ficheiro de configuração da política do utilizador: %USERPROFILE%\Dados de aplicação\Microsoft\CLR security config\vxx.xx\Security.config

Ver também