Criar o arquivo Web.config para um aplicativo ASP.NET

Este artigo descreve como criar o arquivo Web.config usado para controlar o comportamento de aplicativos ASP.NET individuais.

Versão original do produto: ASP.NET
Número original do KB: 815179

Resumo

O Microsoft .NET Framework, e ASP.NET em particular, usa arquivos .config formatados em XML para configurar aplicativos. Essa prática é um desvio dos mecanismos convencionais de configuração de registro e metabase. Atualmente, não há nenhum snap-in do MMC (Console de Gerenciamento Microsoft) ou outra ferramenta de administração fornecida pela Microsoft que você possa usar para criar e modificar arquivos .config.

Hierarquia de arquivos .config

O .NET Framework depende de arquivos .config para definir opções de configuração. Os arquivos .config são arquivos XML baseados em texto. Vários arquivos .config podem existir em um único sistema, e normalmente existem.

As definições de configuração em todo o sistema para o .NET Framework são definidas no arquivo Machine.config . O arquivo Machine.config está localizado na %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ pasta. As configurações padrão contidas no arquivo Machine.config podem ser modificadas para afetar o comportamento dos aplicativos Microsoft .NET em todo o sistema.

Você pode alterar as definições de configuração ASP.NET para um único aplicativo se criar um arquivo Web.config na pasta raiz do aplicativo. Quando você faz isso, as configurações no arquivo Web.config substituem as configurações no arquivo Machine.config .

Criar um arquivo Web.config

Você pode criar um arquivo Web.config usando um editor de texto, como o Bloco de Notas. Você deve criar um arquivo de texto chamado Web.config no diretório raiz do aplicativo ASP.NET. O arquivo Web.config deve ser um documento XML bem formado e deve ter um formato semelhante ao %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config arquivo.

O arquivo Web.config deve conter apenas entradas para itens de configuração que substituem as configurações no arquivo Machine.config . No mínimo, o arquivo Web.config deve ter o <configuration> elemento e o <system.web> elemento. Esses elementos conterão elementos de configuração individuais.

O exemplo a seguir mostra um arquivo Web.config mínimo:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.web>
    </system.web>
</configuration>

A primeira linha do arquivo Web.config descreve o documento como formatado em XML e especifica o tipo de codificação de caracteres. Essa primeira linha deve ser a mesma para todos os arquivos .config.

As linhas a seguir marcam o início e o fim do <configuration> elemento e do <system.web> elemento do arquivo Web.config . Por si só, essas linhas não fazem nada. No entanto, as linhas fornecem uma estrutura que permite adicionar definições de configuração futuras. Você adiciona a maioria das definições de configuração ASP.NET entre as <system.web> linhas e </system.web> . Essas linhas marcam o início e o fim das definições de configuração ASP.NET.

Referências

  • Última atualização em