Configuration Files

Arquivos de configuração são arquivos XML que podem ser alterados conforme necessário. Os desenvolvedores podem usar arquivos de configuração para alterar as configurações sem recompilar os aplicativos. Os administradores podem usar os arquivos de configuração para definir diretivas que afetam como os aplicativos são executados em seus computadores.

Observação

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

Este tópico descreve a sintaxe dos arquivos de configuração e fornece informações sobre os três tipos de arquivos de configuração: máquina, aplicativos e segurança.

Formato de arquivo de configuração

Os arquivos de configuração contêm elementos, que são estruturas de dados lógicos para definir informações de configuração. Dentro de um arquivo de configuração, você pode usar marcas para marcar o início e fim de um elemento. Por exemplo, o <runtime> elemento consiste em <runtime>elementos filho</runtime>. Um elemento vazio tem uma marca de início, mas nenhuma marca de fim.

Especifique a marca de início de definições de configuração usando os atributos predefinidos, que são pares de nome/valor dentro 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 o local de um Assembly).

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

Importante
Assim como todos os arquivos XML, a sintaxe em arquivos de configuração é diferencia maiúsculas de minúsculas.

Arquivos de configuração de máquina

O arquivo de configuração de máquina, Machine. config, contém configurações que se aplicam a todo o computador. Este arquivo está localizado na pasta %caminho de instalação do runtime%\Config directory. Machine. config contém configurações para o assembly de toda a máquina vinculativa, interno canais remotose ASP.NET.

O sistema de configuração primeiro procura no arquivo de configuração de máquina para o elemento appSettings e outras seções de configuração que um desenvolvedor pode definir. Ele procura no arquivo de configuração do aplicativo. Para manter o arquivo de configuração de máquina 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 de máquina seu sistema pode ficar mais passível de manutenção. Por exemplo, se você tiver um componente de terceiros que usa o aplicativo cliente e servidor, é mais fácil colocar as configurações para esse componente em um só lugar. Nesse caso, o arquivo de configuração da máquina é o local adequado para as configurações para que você não tenha as mesmas configurações em dois arquivos diferentes.

Observação

Implantar um aplicativo usando o XCOPY não copiará as configurações no arquivo de configuração de máquina.

Para obter mais informações sobre como o common language runtime usa o arquivo de configuração de máquina para ligação de assembly, consulte Como o Runtime localiza Assemblies.

Arquivos de configuração do aplicativo

Arquivos de configuração de aplicativo contêm configurações específicas de um aplicativo. Este arquivo contém as definições de configuração lê do common language runtime (como diretiva de ligação de assembly, objetos de remoting e assim por diante), e as configurações que o aplicativo pode ler.

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

• Aplicativo Executable–Hosted.

  O arquivo de configuração para um aplicativo hospedado pelo host executável está no mesmo diretório do aplicativo. O nome do arquivo de configuração é o nome do aplicativo com uma extensão. config. Por exemplo, um aplicativo chamado MyApp. exe pode ser associado com um arquivo de configuração chamado myApp.exe.config.

  Observação

  Em projetos de Visual Studio, coloque o arquivo. config no diretório do projeto e definir suas Copiar para diretório de saída propriedade para Copy always ou Copy if newer.Visual Studio copia automaticamente o arquivo para o diretório onde ele compila o assembly.

• ASP.Aplicativo hospedado em NET.

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

• Internet aplicativo hospedado do Explorer.

  Se um aplicativo hospedado no Internet Explorer tem um arquivo de configuração, o local desse arquivo é especificado em um <link> a marca com a seguinte sintaxe:

  < link rel = "ConfigurationFileName" href = "local" >

  Esta marca location é uma URL para o arquivo de configuração. Isso define o aplicativo base. O arquivo de configuração deve estar localizado no mesmo site, como o aplicativo.

Arquivos de configuração de segurança

Arquivos de configuração de segurança contêm informações sobre os grupo hierarquia e permissão conjuntos de códigos associado com um nível de diretiva. É altamente recomendável que você use o .NET Framework (Mscorcfg) ou ferramenta de política de segurança de acesso de código (Caspol. exe) para modificar a diretiva de segurança para garantir que essa diretiva alterações não corromper os arquivos de configuração de segurança.

Observação

Começando com o .NET Framework 4, os arquivos de configuração de segurança estão presentes somente se a diretiva de segurança foi alterada.

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

• Arquivo de configuração de diretiva de empresa: %caminho de instalação do runtime%\Config\Enterprisesec.config

• Arquivo de configuração de diretiva de máquina: %caminho de instalação do runtime%\Config\Security.config

• Arquivo de configuração de diretiva de usuário: Config\v de segurança de data\Microsoft\CLR %USERPROFILE%\Applicationxx\Security.config

Consulte também

Referência

Mscorcfg. msc (.NET Framework Configuration Tool)

Caspol. exe (Code Access Security Policy Tool)

Conceitos

Especificar o local de um Assembly

Redirecionando as versões do Assembly

Assemblies no Common Language Runtime

Outros recursos

Esquema do arquivo de configuração para o.NET Framework

Definições de configuração ASP.NET

Gerenciamento de política de segurança

Remote Objects

Histórico de alterações

Date	History	Motivo
Março de 2011	Informações atualizadas sobre os arquivos de configuração de segurança.	Correção de bug de conteúdo.