Você está offline; aguardando reconexão

Como criar o arquivo Web.config para um aplicativo ASP.NET

Sumário
Este artigo descreve detalhadamente como criar um arquivo Web.config para um aplicativo ASP.NET. O .NET Framework – e o ASP.NET, em particular – utiliza arquivos .config com formatação em XML para configurar aplicativos. Essa prática é uma saída do Registro convencional e mecanismos de configuração de metabase. Atualmente, não existe snap-in do Console de Gerenciamento Microsoft ou outra ferramenta de administração fornecida pela Microsoft que possam ser usados para criar ou modificar arquivos .config.

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

voltar ao início

Hierarquia de arquivos .config

O .NET Framework depende de arquivos .config para definir as opções de configuração. Os arquivos .config são arquivos XML com base em texto. Vários arquivos .config geralmente existem em um único sistema.

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

É possível alterar as configurações de ASP.NET para um único aplicativo se você tiver criado um arquivo Web.config na pasta raiz do aplicativo. Ao fazer isso, as configurações no arquivo Web.config substituirão as configurações do arquivo Machine.config.

voltar ao início

Crie um arquivo Web.config

É possível criar um arquivo Web.config, usando um editor de texto como o Bloco de Notas, por exemplo. É necessário criar um arquivo de texto e nomeá-lo Web.config no diretório raiz do aplicativo ASP.NET. O arquivo Web.config deve ser um documento XML bem formatado e deve ter um formato similar ao arquivo %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config.

O arquivo Web.config deve ter somente entradas para itens de configuração que substituam as configurações do arquivo Machine.config. No mínimo, o arquivo Web.config deve ter o elemento <configuration> e o elemento <system.web>. Esses elementos têm elementos de configuração individuais.

O exemplo a seguir apresenta 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 sendo formatado em XML e especifica o tipo de codificação de caracteres. A primeira linha deve ser idêntica para todos os arquivos .config.

As linhas seguintes devem marcar o início e o término do elemento <configuration> e do elemento <system.web> do arquivo Web.config. Essas linhas não fazem nada por conta própria. No entanto, elas fornecem uma estrutura que permite ao usuário adicionar configurações futuras. A maioria das configurações ASP.NET são adicionadas entre as linhas <system.web> e </system.web>. Essas linhas marcam o início e o término das configurações ASP.NET.

voltar ao início
Referências
Para obter mais informações sobre configuração ASP.NET e sobre o formato dos arquivos de configuração ASP.NET, consulte a documentação do .NET Framework SDK ou visite o seguintes sites da Microsoft (em inglês):

http://msdn2.microsoft.com/en-us/library/aa719558(VS.71).aspx

http://msdn2.microsoft.com/en-us/library/ackhksh7(vs.71).aspx

Para obter informações adicionais, clique no número abaixo para ler o artigo na Base de Dados de Conhecimento Microsoft (a página pode estar em inglês):
815178 Como editar a configuração de um aplicativo ASP.NET
voltar ao início
Propriedades

ID do Artigo: 815179 - Última Revisão: 05/13/2007 05:11:18 - Revisão: 1.9

Microsoft ASP.NET 1.0, Microsoft ASP.NET 1.1

  • kbconfig kbweb kbhowtomaster KB815179
Comentários