arquivo web.config

O web.config é um ficheiro que é lido pelo IIS e pelo Módulo ASP.NET Core para configurar uma app alojada no IIS.

web.config localização do ficheiro

Para configurar corretamente o ASP.NET Módulo Core , o web.config ficheiro deve estar presente no caminho raiz do conteúdo (tipicamente o caminho da base da aplicação) da aplicação implementada. Este é o mesmo local do percurso físico do site fornecido ao IIS. O web.config ficheiro é necessário na raiz da aplicação para permitir a publicação de múltiplas aplicações usando o Web Deploy.

Ficheiros confidenciais estão no caminho físico da aplicação, como {ASSEMBLY}.runtimeconfig.json, {ASSEMBLY}.xml, e {ASSEMBLY}.deps.json (comentários na Documentação XML), onde o marcador {ASSEMBLY} é o nome da assembly. Quando o web.config ficheiro está presente e o site começa normalmente, o IIS não fornece estes ficheiros sensíveis se forem solicitados. Se o web.config ficheiro estiver em falta, tiver um nome incorreto ou não for possível configurar o site para arranque normal, o IIS pode servir ficheiros sensíveis publicamente.

O web.config ficheiro deve estar presente na implementação em todos os momentos, com o nome correto e capaz de configurar o site para arranque normal. Nunca remova o web.config ficheiro de uma implementação em produção.

Se um web.config ficheiro não estiver presente no projeto, o ficheiro é criado com os processPath e arguments corretos para configurar o Módulo do ASP.NET Core e é movido para a saída publicada.

Se um web.config ficheiro estiver presente no projeto, o ficheiro é transformado com o correto processPath e arguments para configurar o Módulo do ASP.NET Core e é movido para a saída publicada. A transformação não modifica as definições de configuração do IIS no ficheiro.

O web.config ficheiro pode fornecer definições adicionais de configuração IIS que controlam módulos IIS ativos. Para informações sobre módulos IIS capazes de processar pedidos com ASP.NET aplicações Core, consulte o tópico dos módulos IIS .

A criação, transformação e publicação do web.config ficheiro são tratadas por um target do MSBuild (_TransformWebConfig) quando o projeto é publicado. Este alvo está presente nos alvos Web SDK (Microsoft.NET.Sdk.Web). O SDK está definido no topo do ficheiro do projeto:

<Project Sdk="Microsoft.NET.Sdk.Web">

Para evitar que o Web SDK transforme o web.config ficheiro, use a <IsTransformWebConfigDisabled> propriedade no ficheiro do projeto:

<PropertyGroup>
  <IsTransformWebConfigDisabled>true</IsTransformWebConfigDisabled>
</PropertyGroup>

Ao desativar o Web SDK de transformar o ficheiro, o processPath e arguments deve ser definido manualmente pelo programador. Para obter mais informações, consulte ASP.NET ANCM (Core Module) para IIS.

Configuração do Módulo ASP.NET Core com web.config

O Módulo ASP.NET Core está configurado com a aspNetCore seção do system.webServer node no ficheiro de configuração do web.config site.

O ficheiro seguinte web.config é publicado para uma implementação dependente do framework e configura o ASP.NET Core Module para lidar com pedidos de site:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath="dotnet"
                  arguments=".\MyApp.dll"
                  stdoutLogEnabled="false"
                  stdoutLogFile=".\logs\stdout"
                  hostingModel="inprocess" />
    </system.webServer>
  </location>
</configuration>

Segue-se web.config é publicado para uma implementação autónoma:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath=".\MyApp.exe"
                  stdoutLogEnabled="false"
                  stdoutLogFile=".\logs\stdout"
                  hostingModel="inprocess" />
    </system.webServer>
  </location>
</configuration>

A propriedade InheritInChildApplications é definida como false para indicar que as definições especificadas dentro do elemento <location> não são herdadas por aplicações que residem num subdiretório da aplicação.

Quando uma aplicação é implementada no Azure App Service, o stdoutLogFile caminho é definido como \\?\%home%\LogFiles\stdout. O caminho guarda os registos stdout na LogFiles pasta, que é uma localização criada automaticamente pelo serviço.

Para informações sobre a configuração das subaplicações IIS, veja Configuração avançada.

Atributos do aspNetCore elemento

Definir variáveis de ambiente

Variáveis de ambiente podem ser especificadas para o processo no processPath atributo. Especifique uma variável de ambiente com o <environmentVariable> elemento filho de um <environmentVariables> elemento de coleção. As variáveis de ambiente definidas nesta secção têm precedência sobre as variáveis de ambiente do sistema.

O exemplo seguinte estabelece duas variáveis de ambiente em web.config. ASPNETCORE_ENVIRONMENT Configura o ambiente da aplicação para Development. Um programador pode definir temporariamente este valor no web.config ficheiro para forçar o carregamento da Página de Exceção do Desenvolvedor ao depurar uma exceção de aplicação. CONFIG_DIR é um exemplo de variável de ambiente definida pelo utilizador, onde o programador escreveu código que lê o valor no arranque para formar um caminho para carregar o ficheiro de configuração da aplicação.

<aspNetCore processPath="dotnet"
      arguments=".\MyApp.dll"
      stdoutLogEnabled="false"
      stdoutLogFile=".\logs\stdout"
      hostingModel="inprocess">
  <environmentVariables>
    <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
    <environmentVariable name="CONFIG_DIR" value="f:\application_config" />
  </environmentVariables>
</aspNetCore>

<PropertyGroup>
  <EnvironmentName>Development</EnvironmentName>
</PropertyGroup>

Configuração do IIS com web.config

A configuração do IIS é influenciada pela secção <system.webServer> de web.config para cenários do IIS que são funcionais com aplicações ASP.NET Core utilizando o Módulo ASP.NET Core. Por exemplo, a configuração IIS é funcional para compressão dinâmica. Se o IIS estiver configurado ao nível do servidor para usar compressão dinâmica, o <urlCompression> elemento no ficheiro da web.config aplicação pode desativá-lo para uma aplicação ASP.NET Core.

Para obter mais informações, consulte os seguintes tópicos:

• Referência de configuração para <system.webServer>
• ASP.NET Módulo Principal (ANCM) para IIS
• Módulos IIS com ASP.NET Core

Para definir variáveis de ambiente para aplicações individuais a correr em pools de aplicações isoladas (suportado para IIS 10.0 ou posterior), consulte a AppCmd.exe secção de comandos do tópico Variáveis <environmentVariables>de Ambiente na documentação de referência do IIS.

Secções de configuração de web.config

As secções de configuração de aplicações ASP.NET 4.x em web.config não são usadas por aplicações ASP.NET Core para configuração:

• <system.web>
• <appSettings>
• <connectionStrings>
• <location>

ASP.NET aplicações Core são configuradas usando outros fornecedores de configuração. Para obter mais informações, consulte Configuração.

Transforme web.config

Se precisares de transformar web.config aquando da publicação, vê Transformar web.config. Poderá ser necessário transformar web.config durante a publicação para definir variáveis de ambiente com base na configuração, no perfil ou no ambiente.

Recursos adicionais

• IIS <system.webServer>
• Módulos IIS com ASP.NET Core
• Transformar web.config