Instalowanie platformy Entity Framework CoreInstalling Entity Framework Core

Wymagania wstępnePrerequisites

  • Do tworzenia aplikacji przeznaczonych dla platformy .NET Core 2.1, należy zainstalować zestawu SDK programu .NET Core 2.1.To develop apps that target .NET Core 2.1, install the .NET Core 2.1 SDK. Zestaw SDK został zainstalowany, nawet jeśli masz najnowszą wersję programu Visual Studio 2017.The SDK has to be installed even if you have the latest version of Visual Studio 2017.

  • Aby użyć programu Visual Studio do tworzenia aplikacji przeznaczonych dla platformy .NET Core 2.1, należy zainstalować Visual Studio 2017 w wersji 15.7 lub nowszej.To use Visual Studio for development of apps that target .NET Core 2.1, install Visual Studio 2017 version 15.7 or later.

  • Aby używać programu Entity Framework 2.1 w aplikacji platformy ASP.NET Core, należy użyć platformy ASP.NET Core 2.1.To use Entity Framework 2.1 in ASP.NET Core applications, use ASP.NET Core 2.1. Aplikacje, które używają starszych wersji platformy ASP.NET Core, musi zostać zaktualizowany do wersji 2.1.Applications that use earlier versions of ASP.NET Core must be updated to 2.1.

  • Można użyć programu Visual Studio 2015 dla aplikacji przeznaczonych dla platformy .NET Framework 4.6.1 lub nowszej.You can use Visual Studio 2015 for apps that target the .NET Framework 4.6.1 or later. Jednak potrzebna jest wersja pakietu nuget, rozpoznający .NET Standard 2.0 i jego struktury zgodne.But you need a version of NuGet that is aware of the .NET Standard 2.0 and its compatible frameworks. Aby uzyskać tę w programie Visual Studio 2015 uaktualnić klienta programu NuGet w wersji 3.6.0.To get that in Visual Studio 2015, upgrade the NuGet client to version 3.6.0.

Pobierz środowisko uruchomieniowe programu Entity Framework CoreGet the Entity Framework Core runtime

Aby dodać biblioteki środowiska uruchomieniowego EF Core do aplikacji, należy zainstalować pakiet NuGet dla dostawcy bazy danych, którego chcesz użyć.To add EF Core runtime libraries to an application, install the NuGet package for the database provider you want to use. Aby uzyskać listę obsługiwanych dostawców i ich nazwy pakietów NuGet, zobacz bazy danych dostawcy.For a list of supported providers and their NuGet package names, see Database providers.

Instalowanie lub aktualizowanie pakietów NuGet, przy użyciu interfejsu wiersza polecenia platformy .NET Core, okno dialogowe programu Visual Studio pakietu Menedżera lub konsoli Menedżera pakietów Visual Studio.To install or update NuGet packages, use the .NET Core CLI, the Visual Studio Package Manager Dialog, or the Visual Studio Package Manager Console.

W przypadku aplikacji platformy ASP.NET Core 2.1 w pamięci i dostawcy programu SQL Server są automatycznie dołączane, więc nie trzeba instalować ich osobno.For ASP.NET Core 2.1 applications, the in-memory and SQL Server providers are automatically included, so there's no need to install them separately.

Porada

Jeśli musisz zaktualizować aplikację, która używa dostawcy bazy danych innej firmy, Zawsze sprawdzaj dostępność aktualizacji dostawcy, który jest zgodny z wersją programu EF Core, którego chcesz użyć.If you need to update an application that is using a third-party database provider, always check for an update of the provider that is compatible with the version of EF Core you want to use. Na przykład dostawcy baz danych dla wcześniejszych wersji nie są zgodne z środowiska uruchomieniowego EF Core w wersji 2.1.For example, database providers for previous versions are not compatible with version 2.1 of the EF Core runtime.

.NET core interfejsu wiersza polecenia.NET Core CLI

Następujące polecenie interfejsu wiersza polecenia platformy .NET Core instaluje lub aktualizuje dostawcy programu SQL Server:The following .NET Core CLI command installs or updates the SQL Server provider:

dotnet add package Microsoft.EntityFrameworkCore.SqlServer

Można wskazać określonej wersji w dotnet add package polecenia przy użyciu -v modyfikator.You can indicate a specific version in the dotnet add package command, using the -v modifier. Na przykład, aby zainstalować pakiety programu EF Core 2.1.0, należy dołączyć -v 2.1.0 do polecenia.For example, to install EF Core 2.1.0 packages, append -v 2.1.0 to the command.

Okno Menedżera pakietów NuGet programu Visual StudioVisual Studio NuGet Package Manager Dialog

  • W menu, wybierz opcję Projekt > Zarządzaj pakietami NuGetFrom the menu, select Project > Manage NuGet Packages

  • Kliknij pozycję Przeglądaj lub aktualizacje kartęClick on the Browse or the Updates tab

  • Aby zainstalować lub zaktualizować dostawcy programu SQL Server, wybierz Microsoft.EntityFrameworkCore.SqlServer pakietu i potwierdź.To install or update the SQL Server provider, select the Microsoft.EntityFrameworkCore.SqlServer package, and confirm.

Aby uzyskać więcej informacji, zobacz okno Menedżera pakietów NuGet.For more information, see NuGet Package Manager Dialog.

Konsola Menedżera pakietów NuGet dla programu Visual StudioVisual Studio NuGet Package Manager Console

  • W menu, wybierz opcję Narzędzia > Menedżer pakietów NuGet > Konsola Menedżera pakietówFrom the menu, select Tools > NuGet Package Manager > Package Manager Console

  • Aby zainstalować dostawcę programu SQL Server, uruchom następujące polecenie w konsoli Menedżera pakietów:To install the SQL Server provider, run the following command in the Package Manager Console:

    Install-Package Microsoft.EntityFrameworkCore.SqlServer
    
  • Aby zaktualizować dostawcę, użyj Update-Package polecenia.To update the provider, use the Update-Package command.

  • Aby określić określonej wersji, użyj -Version modyfikator.To specify a specific version, use the -Version modifier. Na przykład, aby zainstalować pakiety programu EF Core 2.1.0, należy dołączyć -Version 2.1.0 poleceńFor example, to install EF Core 2.1.0 packages, append -Version 2.1.0 to the commands

Aby uzyskać więcej informacji, zobacz Konsola Menedżera pakietów.For more information, see Package Manager Console.

Pobierz narzędzia platformy Entity Framework CoreGet Entity Framework Core tools

Oprócz bibliotek środowiska uruchomieniowego można zainstalować narzędzia, które mogą wykonywać niektóre zadania związane z programem EF Core w projekcie w czasie projektowania.Besides the runtime libraries, you can install tools that can perform some EF Core-related tasks in your project at design time. Na przykład można utworzyć migracje, zastosować migracje i utworzyć model, w oparciu o istniejącą bazę danych.For example, you can create migrations, apply migrations, and create a model based on an existing database.

Dostępne są dwa zestawy narzędzi:Two sets of tools are available:

Chociaż można używać dotnet ef poleceń z poziomu konsoli Menedżera pakietów jest bardziej wygodne do korzystania z narzędzi Konsola Menedżera pakietów, podczas korzystania z programu Visual Studio:Although you can use the dotnet ef commands from the Package Manager Console, it's more convenient to use the Package Manager Console tools when you're using Visual Studio:

  • Działają automatycznie z bieżącego projektu wybrany w konsoli Menedżera pakietów, bez konieczności ręcznie zmienić katalog.They automatically work with the current project selected in the Package Manager Console without requiring manually switching directories.
  • One automatycznie otwarte pliki wygenerowane za pomocą poleceń w programie Visual Studio po zakończeniu polecenia.They automatically open files generated by the commands in Visual Studio after the command is completed.

Pobierz narzędzia interfejsu wiersza poleceniaGet the CLI tools

dotnet ef Poleceń są zawarte w zestawie SDK programu .NET Core, ale aby włączyć polecenia należy zainstalować Microsoft.EntityFrameworkCore.Design pakietu:The dotnet ef commands are included in the .NET Core SDK, but to enable the commands you have to install the Microsoft.EntityFrameworkCore.Design package:

dotnet add package Microsoft.EntityFrameworkCore.Design 

W przypadku aplikacji platformy ASP.NET Core 2.1 Ten pakiet jest uwzględniane automatycznie.For ASP.NET Core 2.1 apps, this package is included automatically.

Jak wyjaśniono wcześniej w wymagania wstępne, należy także zainstalować zestaw SDK programu .NET Core 2.1.As explained earlier in Prerequisites, you also need to install the .NET Core 2.1 SDK.

Ważne

Zawsze używaj wersji zgodnej wersji głównej pakiety środowiska uruchomieniowego pakietu Narzędzia.Always use the version of the tools package that matches the major version of the runtime packages.

Pobierz narzędzia w konsoli Menedżera pakietówGet the Package Manager Console tools

Aby uzyskać Konsola Menedżera pakietów narzędzi dla platformy EF Core, należy zainstalować Microsoft.EntityFrameworkCore.Tools pakietu:To get the Package Manager Console tools for EF Core, install the Microsoft.EntityFrameworkCore.Tools package:

dotnet add package Microsoft.EntityFrameworkCore.Tools

W przypadku aplikacji platformy ASP.NET Core 2.1 Ten pakiet jest uwzględniane automatycznie.For ASP.NET Core 2.1 apps, this package is included automatically.

Uaktualnianie do EF Core 2.1Upgrading to EF Core 2.1

Jeśli aktualizujesz istniejącą aplikację platformy EF Core 2.1 niektórych odwołań do starszych pakietów programu EF Core może być konieczne ręczne usunięcie:If you're upgrading an existing application to EF Core 2.1, some references to older EF Core packages may need to be removed manually:

  • Bazy danych dostawcy projektowania pakietów, takich jak Microsoft.EntityFrameworkCore.SqlServer.Design nie jest już wymagane lub obsługiwanych w programie EF Core 2.1, ale nie są automatycznie usuwane po uaktualnieniu innych pakietów.Database provider design-time packages such as Microsoft.EntityFrameworkCore.SqlServer.Design are no longer required or supported in EF Core 2.1, but aren't automatically removed when upgrading the other packages.

  • Narzędzia wiersza polecenia platformy .NET zawiera teraz zestaw .NET SDK, odwołanie do tego pakietu może zostać usunięty z .csproj pliku:The .NET CLI tools are now included in the .NET SDK, so the reference to that package can be removed from the .csproj file:

    <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.0" />
    

W przypadku aplikacji dla środowiska .NET Framework, które zostały utworzone we wcześniejszych wersjach programu Visual Studio upewnij się, że są one zgodne z bibliotekami .NET Standard 2.0:For applications that target the .NET Framework and were created by earlier versions of Visual Studio, make sure that they are compatible with .NET Standard 2.0 libraries:

  • Edytuj plik projektu i upewnij się, że w grupie właściwości początkowe pojawia się następujący wpis:Edit the project file and make sure the following entry appears in the initial property group:

    <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
    
  • Dla projektów testowych również upewnij się, że występuje następujący wpis:For test projects, also make sure the following entry is present:

    <GenerateBindingRedirectsOutputType>true</GenerateBindingRedirectsOutputType>