Editar a configuração de um aplicativo ASP.NET
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:
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.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" />
Copie todo o elemento de configuração e qualquer comentário inicial para a área de transferência.
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 .
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.
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.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
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários