Partilhar via

Instalando o Entity Framework Core

Prerequisites

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

    • Em tempo de execução, o EF Core requer uma versão recente do .NET. Consulte 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.

  • Você pode usar o EF Core para desenvolver aplicativos no Windows usando o Visual Studio. A versão mais recente do Visual Studio é recomendada.

Obter o Entity Framework Core

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

Para instalar ou atualizar pacotes NuGet, você pode usar a interface de linha de comando (CLI) .NET, a caixa de diálogo Gerenciador de Pacotes do Visual Studio ou o Console do Gerenciador de Pacotes do Visual Studio.

.NET CLI

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

    dotnet add package Microsoft.EntityFrameworkCore.SqlServer

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

Para obter mais informações, consulte Ferramentas de interface de linha de comando (CLI) do .NET.

Caixa de diálogo Gestor de Pacotes NuGet do Visual Studio

  • No menu Visual Studio, selecione Project > Manage NuGet Packages

  • Clique na guia Procurar ou Atualizações

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

Para obter mais informações, consulte Caixa de diálogo Gerenciador de Pacotes NuGet.

Console do Gerenciador de Pacotes NuGet do Visual Studio

  • No menu Visual Studio, selecione Ferramentas > NuGet Package Manager > 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 Update-Package comando.

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

Para obter mais informações, consulte Console do Gerenciador de Pacotes.

Obtenha as ferramentas principais do Entity Framework

Você pode instalar ferramentas para executar tarefas relacionadas ao EF Core em seu projeto, como criar e aplicar migrações de banco de dados ou criar um modelo EF Core com base em um banco de dados existente.

Estão disponíveis dois conjuntos de ferramentas:

Obtenha as ferramentas da CLI do .NET

As ferramentas da CLI do .NET exigem o SDK do .NET, mencionado anteriormente em Pré-requisitos.

  • dotnet ef deve ser instalado como uma ferramenta global ou local. A maioria dos desenvolvedores prefere instalar o 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. Para usá-lo como uma ferramenta local, restaure as dependências de um projeto que o declara como uma dependência de ferramentas usando um arquivo de manifesto da ferramenta .

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

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

    dotnet add package Microsoft.EntityFrameworkCore.Design

Important

Sempre use a versão do pacote de ferramentas que corresponde à versão principal dos pacotes de tempo de execução.

Obtenha as ferramentas do Console do Gerenciador de Pacotes

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

Install-Package Microsoft.EntityFrameworkCore.Tools

Atualizando 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 EF Core, como Microsoft.EntityFrameworkCore.SqlServer, Microsoft.EntityFrameworkCore.Sqlite, Microsoft.EntityFrameworkCore.Cosmos e Microsoft.EntityFrameworkCore.InMemory. Você pode apenas 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 que seja compatível com a versão do EF Core que você deseja usar. Por exemplo, os provedores de banco de dados para a versão 1.0 não são compatíveis com a versão 2.0 do tempo de execução do EF Core e assim por diante.

  • Os provedores de terceiros para o EF Core geralmente não lançam versões de patch juntamente com o tempo de execução 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 tempo de execução individuais do EF Core, principalmente Microsoft.EntityFrameworkCore e Microsoft.EntityFrameworkCore.Relational.

  • Last updated on