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

  • Artigo

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 de KB original: 815179

Resumo

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

Hierarquia de arquivos de .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 e normalmente existem em um único sistema.

As configurações 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 .NET da Microsoft em todo o sistema.

Você pode alterar as configurações de 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 arquivoWeb.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 seu aplicativo ASP.NET. O arquivoWeb.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 substituam as configurações no arquivo Machine.config . No mínimo, o arquivoWeb.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 deWeb.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 por 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 final do <configuration> elemento e o <system.web> elemento do arquivoWeb.config . Por si só, essas linhas não fazem nada. No entanto, as linhas fornecem uma estrutura que permite adicionar configurações futuras. Você adiciona a maioria das configurações ASP.NET configuração entre as <system.web> linhas e </system.web> . Essas linhas marcam o início e o fim das configurações de configuração ASP.NET.

Referências