Editar a configuração de um aplicativo ASP.NET

  • Artigo

Este artigo descreve como editar o arquivo Web.config de um aplicativo ASP.NET.

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

Resumo

O arquivo Web.config define o comportamento de aplicativos ASP.NET. O Microsoft .NET Framework, incluindo ASP.NET, usa arquivos de texto .config formatados por XML para configurar aplicativos. Trata-se de uma saída dos mecanismos convencionais de configuração de registro e metabase. Atualmente, não há nenhum snap-in do Microsoft Management Console (MMC) ou outra ferramenta de administração fornecida pela Microsoft para criar e modificar arquivos .config.

Adicionar configurações ao Web.config

A maioria dos aplicativos ASP.NET vem com um arquivo deWeb.config predefinido que pode ser editado com qualquer editor de texto, como o Bloco de Notas. Geralmente, Web.config arquivos contêm comentários que tornam a edição do arquivo autoexplicativa. No entanto, talvez você precise adicionar itens de configuração a um arquivo Web.config que ainda não tenha o item de configuração definido. Para adicionar um item de configuração padrão a um arquivo Web.config , siga estas etapas:

  1. Abra o arquivo Machine.config em um editor de texto, como Bloco de Notas.

    O arquivoMachine.config está localizado no %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ diretório.

  2. No arquivo Machine.config , localize a configuração que você deseja substituir no arquivo Web.config . Quando o elemento é mais de uma linha, o elemento começa com uma <element_name> linha e termina com </element_name>. O elemento também pode ser auto-fechamento e pode ser semelhante a <element_name attribute1='option' attribute2='option' />. Espaço em branco é ignorado. Portanto, o elemento pode abranger várias linhas. O elemento pode ser precedido por um comentário. O comentário está contido em marcas internas <!-- and --> . O <trace> exemplo de elemento de configuração a seguir é um exemplo de um elemento de auto-fechamento. O <trace> exemplo do elemento de configuração tem vários atributos, abrange várias linhas e tem um comentário no início.

    <!--
trace Attributes:
    enabled="[true|false]" - Enable application tracing
    localOnly="[true|false]" - View trace results from localhost only
    pageOutput="[true|false]" - Display trace output on individual pages
    requestLimit="[number]" - Number of trace results available in trace.axd
    traceMode="[SortByTime|SortByCategory]" - Sorts trace result displays based on Time or Category
 -->
<trace
    enabled="false"
    localOnly="true"
    pageOutput="false"
    requestLimit="10"
    traceMode="SortByTime"
/>

  3. Copie todo o elemento de configuração e qualquer comentário inicial para a área de transferência.

  4. Determine como o elemento está aninhado no arquivo Machine.config .

    O arquivoMachine.config é hierárquico e os elementos de configuração são aninhados em outros elementos. Ao copiar um elemento de configuração do arquivoMachine.config para o arquivo Web.config , você deve aninhar esse elemento de configuração no mesmo elemento do qual ele foi copiado. Para determinar o elemento do arquivoMachine.config no qual o elemento de configuração está contido, role para cima no arquivo Machine.config até encontrar um elemento aberto, não fechado. O elemento de contenção é simples de identificar porque elementos de nível superior têm menos recuo.

    A maioria dos itens de configuração ASP.NET estão contidos no <system.web> elemento. O final do elemento ( </system.web> ) deve ser colocado após o elemento de configuração.

    Observação

    O elemento no qual o elemento de configuração está contido. Você deve colar esse elemento no mesmo elemento no arquivo Web.config . Um elemento de configuração pode ser aninhado em vários elementos. Você deve criar todos os elementos de nível superior no arquivo Web.config .

  5. Feche o arquivo Machine.config e use o editor de texto para abrir o arquivo Web.config no diretório raiz do aplicativo ASP.NET.

  6. Cole o elemento de configuração entre o início e o final do elemento que você identificou na etapa 4.

    Por exemplo, se o item de configuração estiver contido no <system.web> elemento, o item de configuração deverá ser colado imediatamente após a linha de abertura do elemento e antes da </system.web> linha de <system.web> fechamento.

  7. Modifique o elemento de configuração no arquivo Web.config para substituir a configuração deMachine.config para esse aplicativo.

    Essa configuração se aplica à pasta que contém o arquivo Web.config e todas as subpastas.

Referências