Instalar o Entity Framework Core

  • Artigo

Pré-requisitos

  • O EF requer o SDK do .NET mais recente.

    • No runtime, o EF Core requer uma versão recente do .NET. Consulte as versões do EF Core para encontrar a versão mínima do .NET necessária para a versão do EF Core que você deseja usar.

  • É possível usar o EF Core para desenvolver aplicativos no Windows usando o Visual Studio. É recomendável usar a versão mais recente do Visual Studio.

Obter o Entity Framework Core

O EF Core é enviado como pacotes NuGet. Para adicionar o EF Core a um aplicativo, instale o pacote do NuGet do provedor de banco de dados que você quer usar. Consulte Provedores para obter uma lista dos provedores de banco de dados disponíveis.

Para instalar ou atualizar os pacotes NuGet, use a CLI (interface de linha de comando) do .NET Core, a Caixa de Diálogo do Gerenciador de Pacotes do Visual Studio ou o Console do Gerenciador de Pacotes do Visual Studio.

CLI do .NET Core

  • Use o seguinte comando da CLI do .NET Core na linha de comando do sistema operacional para instalar ou atualizar o provedor de SQL Server do EF Core:

    dotnet add package Microsoft.EntityFrameworkCore.SqlServer

  • É possível indicar uma versão específica no comando dotnet add package, usando o modificador -v. Por exemplo, para instalar pacotes do EF Core 6.0.14, acrescente -v 6.0.14 ao comando.

Para saber mais, confira Ferramentas da CLI (interface de linha de comando) do .NET.

Caixa de diálogo do gerenciador de pacotes do NuGet do Visual Studio

  • No menu do Visual Studio, selecione Projeto> Gerenciar Pacotes do NuGet

  • Clique na guia Procurar ou Atualizações

  • Para instalar ou atualizar o provedor do SQL Server, selecione o pacote Microsoft.EntityFrameworkCore.SqlServer e confirme.

Para saber mais, confira Caixa de Diálogo do Gerenciador de Pacotes do NuGet.

Console do gerenciador de pacotes do NuGet do Visual Studio

  • No menu do Visual Studio, selecione Ferramentas >Gerenciador de Pacotes do NuGet > Console do Gerenciador de Pacotes

  • Para instalar o provedor do SQL Server, execute o seguinte comando no Console do Gerenciador de Pacotes:

    Install-Package Microsoft.EntityFrameworkCore.SqlServer

  • Para atualizar o provedor, use o comando Update-Package.

  • Para especificar uma versão, use o modificador -Version. Por exemplo, para instalar pacotes do EF Core 6.0.14, acrescente -Version 6.0.14 aos comandos

Para saber mais, confira Console do gerenciador de pacotes.

Obtenha as ferramentas do Entity Framework Core

É possível instalar ferramentas para realizar tarefas relacionadas com o EF Core no projeto, como criar e aplicar migrações de banco de dados ou criar um modelo do EF Core baseado em um banco de dados existente.

Dois conjuntos de ferramentas estão disponíveis:

Obtenha as ferramentas da CLI do .NET Core

As ferramentas da CLI do .NET Core precisam do SDK do .NET Core mencionado anteriormente nos Pré-requisitos.

  • dotnet ef deve ser instalado como uma ferramenta global ou local. A maioria dos desenvolvedores prefere instalar dotnet ef como uma ferramenta global usando o seguinte comando:

    dotnet tool install --global dotnet-ef

    dotnet ef também pode ser usado como uma ferramenta local. Você também pode obtê-lo como uma ferramenta local quando você restaura as dependências de um projeto que o declara como uma dependência de ferramentas usando um arquivo de manifesto de ferramenta.

  • Para atualizar as ferramentas, use o comando dotnet tool update.

  • Instale o pacote Microsoft.EntityFrameworkCore.Design mais recente.

    dotnet add package Microsoft.EntityFrameworkCore.Design

Importante

Sempre use a versão do pacote de ferramentas que corresponda à versão principal dos pacotes em runtime.

Obter as ferramentas do Console do Gerenciador de Pacotes

Para obter as ferramentas do Console do Gerenciador de Pacotes para EF Core, instale o pacote Microsoft.EntityFrameworkCore.Tools. Por exemplo, no Visual Studio:

Install-Package Microsoft.EntityFrameworkCore.Tools

Atualizar para o EF Core mais recente

  • Sempre que lançamos uma nova versão do EF Core, também lançamos uma nova versão dos provedores que fazem parte do projeto do EF Core, como Microsoft.EntityFrameworkCore.SqlServer, Microsoft.EntityFrameworkCore.Sqlite, Microsoft.EntityFrameworkCore.Cosmos e Microsoft.EntityFrameworkCore.InMemory. Basta atualizar para a nova versão do provedor para obter todas as melhorias.

  • Se você precisar atualizar um aplicativo que esteja usando um provedor de banco de dados de terceiros, sempre verifique se há uma atualização do provedor compatível com a versão do EF Core que você deseja usar. Por exemplo, provedores de banco de dados para a versão 1.0 não são compatíveis com a versão 2.0 do runtime do EF Core.

  • Normalmente, os provedores de terceiros do EF Core não lançam versões de patch junto com o runtime do EF Core. Para atualizar um aplicativo que usa um provedor de terceiros para uma versão de patch do EF Core, talvez seja necessário adicionar uma referência direta aos componentes de runtime do EF Core, mais notavelmente Microsoft.EntityFrameworkCore e Microsoft.EntityFrameworkCore.Relational.