Como: Criar arquivos Web.config

Artigo
10/15/2014

O ASP.NET usa uma hierarquia de arquivos de texto XML, cada um nomeado Web.config, para armazenar configurações que controlam como seu site funciona.Usando os recursos do sistema configuração ASP.NET, você pode configurar um servidor inteiro, um aplicativo ASP.NET ou páginas individuais.Este tópico descreve como criar um arquivo Web.config no Visual Web Developer.

Para criar um arquivo Web.config

No Solution Explorer, clique no ícone Refresh para certificar-se de que um arquivo Web.config ainda não existe para seu aplicativo.

Caso você já tenha usado a Web Site Administration Tool ou algum outro meio para configurar seu aplicativo, um arquivo Web.config foi criado automaticamente.Clicar em Refresh irá atualizar a lista de arquivos.
No Solution Explorer, clique com o botão direito do mouse no nome do site e, em seguida, clique em Add New Item.
Na janela Templates, clique em Web Configuration File.

O nome do arquivo na caixa de texto Nome deve ser Web.config.Você pode dar outro nome ao arquivo, mas esse é o padrão.A extensão .config é protegida contra download pelo ASP.NET.
Clique em Add para criar o arquivo e abra-o para edição.

O arquivo contém o código mostrado na seção "Exemplo" mais adiante neste tópico, com algumas inicializações padrão.Seu aplicativo herda todas as definições de configuração dos arquivos Machine.config e Web.config no diretório %SystemRoot%\Microsoft.NET\Framework\<version>\CONFIG, mas você não verá essas definições padrão aqui.Arquivos Web.config no nível do aplicativo ou no nível de diretório só precisam ser criados se você deseja substituir as configurações padrão herdadas ou adicionar elementos da coleção como httpHandlers elemento (esquema configurações ASP.NET).

Para exibir todas as configurações para o seu aplicativo atual, você pode executar o código incluído no tópico Como: Exibir configurações locais e herdado configuração programaticamente.Como alternativa, você pode visualizar os arquivos Machine.config.comments ou Web.config.comments (que também contêm comentários úteis) no diretório %SystemRoot%\Microsoft.NET\Framework\<version>\CONFIG, mas esses dois arquivos não conterão todas as suas configurações de tempo de execuçãoComo: Exibir configurações locais e herdado configuração programaticamente.
Caso você tenha alterado o arquivo Web.config, salve-o.

Salvar um arquivo Web.config irá reiniciar o aplicativo.Você também pode, como alternativa, usar o atributo configSource de elementos de seção individuais para apontar para um arquivo de configuração secundário que não cause uma reinicialização do aplicativo quando ele for alterado.Para mais informações, consulte configSource em Atributos de Geral herdados por elementos de seção.

Usar o IntelliSense para editar configurações

No Visual Web Developer, abra o arquivo Web.config.
Na janela de edição, coloque o cursor dentro das abas <system.web> </system.web> em uma linha por si só, mas não dentrode outras abas.
Digite o símbolo de "menor que" (<) para iniciar um novo elemento.

Aparecerá uma lista suspensa que oferece elementos válidos para adicionar a este ponto de inserção.Como alternativa, você pode pressionar Ctrl+J para exibir a lista suspensa sem digitar o símbolo de menor que.
Selecione anonymousIdentification.

O elemento anonymousIdentification elemento (esquema configurações ASP.NET) é colocado no seu arquivo Web.config e é encerrado.Se um elemento é finalizado com uma marca de fechamento, então existem elementos-filho disponíveis para serem definidos.Se um elemento é finalizado, como o seguinte elemento anonymousIdentification, não há elementos-filho disponíveis para serem definidos.
```
<anonymousIdentification />
```
Coloque o cursor dentro da aba <anonymousIdentification /> e, em seguida, pressione a tecla ESPAÇO.

Aparecerá uma lista suspensa que oferece atributos válidos para adicionar ao elemento anonymousIdentification.Como alternativa, você pode pressionar Ctrl+J para exibir a lista suspensa sem pressionar a tecla BARRA DE ESPAÇO.
Selecione enabled.

O atributo enabled é colocado no seu arquivo Web.config e, por ele ser um atributo booleano, os valores de true e false são oferecidos em uma lista suspensa.
Selecione false.Padrão do sistema.

O sistema IntelliSense faz sugestões para elementos e atributos que estão disponíveis no ponto de inserção.Às vezes, atributos especializados não são oferecidos.Por exemplo, ao configurar um elemento providers, como para o elemento siteMap elemento (esquema configurações ASP.NET), atributos diferentes estão disponíveis dependendo do tipo de provedor que você está adicionando.O IntelliSense não mostra esses atributos, pois eles dependem do valor do atributo type.
Altere o valor do atributo enabled para "falsex", que é um valor inválido.

O sistema IntelliSense fornece uma verificação de validação e exibe uma pequena linha sob qualquer texto que não seja válido.

Exemplo

Exemplo de código a seguir ilustra o conteúdo inicial de um arquivo Web.config criado pelo Visual Web Developer.Configurações padrão são fornecidas para elementos compilation e autentication.Para habilitar a depuração ASP.NET, tudo o que você deve fazer é alterar o atributo debug do elemento compilation para true.Todos os elementos que podem aparecer dentro do elemento system.web são documentados em Definições de configuração ASP.NET.

<?xml version="1.0"?>
<!-- 
    Note: As an alternative to hand editing this file you can use the 
    Web Site Administration Tool to configure settings for your application. Use
    the Web site->Asp.Net Configuration option in Visual Studio.
    A full list of settings and comments can be found in 
    machine.config.comments usually located in 
    \Windows\Microsoft.Net\Framework\v2.x\Config 
-->
<configuration xmlns="https://schemas.microsoft.com/.NetConfiguration/v2.0">
    <appSettings/>
    <connectionStrings/>
    <system.web>
        <!-- 
            Set compilation debug="true" to insert debugging 
            symbols into the compiled page. Because this 
            affects performance, set this value to true only 
            during development.
        -->
        <compilation debug="false"/>
        <!--
            The <authentication> section enables configuration 
            of the security authentication mode used by 
            ASP.NET to identify an incoming user. 
        -->
        <authentication mode="Windows"/>
        <!--
            The <customErrors> section enables configuration 
            of what to do if/when an unhandled error occurs 
            during the execution of a request. Specifically, 
            it enables developers to configure html error pages 
            to be displayed in place of a error stack trace.

        <customErrors mode="RemoteOnly" defaultRedirect="GenericErrorPage.htm">
            <error statusCode="403" redirect="NoAccess.htm"/>
            <error statusCode="404" redirect="FileNotFound.htm"/>
        </customErrors>
        -->
    </system.web>
</configuration>

Segurança

Ao armazenar informações sigilosas em um arquivo de configuração para um aplicativo, você deve criptografar os valores confidenciais usando uma configuração protegida.Para obter mais informações sobre isso e sobre outras questões de segurança para arquivos de configuração, consulte Protegendo configuração ASP.NET.