Migrar a configuração para o ASP.NET Core

No artigo anterior, começamos a migrar um projeto MVC ASP.NET para ASP.NET Core MVC. Neste artigo, migramos a configuração.

Exibir ou baixar código de exemplo (como baixar)

Configuração de instalação

ASP.NET Core não usa mais os arquivos Global.asax e web.config utilizados pelas versões anteriores do ASP.NET. Nas versões anteriores do ASP.NET, a lógica de inicialização do aplicativo era colocada em um Application_StartUp método no Global.asax. Posteriormente, em ASP.NET MVC, um Startup.cs arquivo foi incluído na raiz do projeto; e foi chamado quando o aplicativo foi iniciado. ASP.NET Core adotou essa abordagem completamente colocando toda a lógica de inicialização no Startup.cs arquivo.

O arquivo web.config também foi substituído no ASP.NET Core. A configuração em si agora pode ser configurada, como parte do procedimento de inicialização do aplicativo descrito em Startup.cs. A configuração ainda pode utilizar arquivos XML, mas normalmente os projetos do ASP.NET Core colocarão valores de configuração em um arquivo formatado em JSON, como appsettings.json. O sistema de configuração do ASP.NET Core também pode acessar facilmente variáveis de ambiente, o que pode fornecer um local mais seguro e robusto para valores específicos do ambiente. Isso é especialmente verdadeiro para segredos como cadeias de conexão e chaves de API que não devem ser verificadas no controle do código-fonte. Consulte Configuração para saber mais sobre a configuração no ASP.NET Core.

Warning

Este artigo usa um banco de dados local que não exige que o usuário seja autenticado. Os aplicativos de produção devem usar o fluxo de autenticação mais seguro disponível. Para obter mais informações sobre autenticação para aplicativos de teste e produção implantados, consulte Fluxos de autenticação seguros.

Para configurar, adicione o seguinte construtor e a propriedade ao arquivo Startup.cs localizado na raiz do projeto:

public Startup(IConfiguration configuration)
{
    Configuration = configuration;
}

public IConfiguration Configuration { get; }

Observe que, neste ponto, o Startup.cs arquivo não será compilado, pois ainda precisamos adicionar a seguinte using instrução:

using Microsoft.Extensions.Configuration;

Adicione um appsettings.json arquivo à raiz do projeto usando o modelo de item apropriado:

Migrar configurações de web.config

Nosso projeto ASP.NET MVC incluiu a cadeia de conexão de banco de dados necessária em web.config, no <connectionStrings> elemento. Em nosso projeto ASP.NET Core, vamos armazenar essas informações no appsettings.json arquivo. Abra appsettings.jsone observe que ele já inclui o seguinte:

{
    "Data": {
        "DefaultConnection": {
            "ConnectionString": "Server=(localdb)\\MSSQLLocalDB;Database=_CHANGE_ME;Trusted_Connection=True;"
        }
    }
}

Na linha realçada descrita acima, altere o nome do banco de dados _CHANGE_ME para o nome do seu banco de dados.

Summary

ASP.NET Core coloca toda a lógica de inicialização do aplicativo em um único arquivo, no qual os serviços e dependências necessários podem ser definidos e configurados. Ele substitui o arquivo web.config por um recurso de configuração flexível que pode aproveitar uma variedade de formatos de arquivo, como JSON, bem como variáveis de ambiente.