Prerequisites
EF には最新の .NET SDK が必要です。
- 実行時に、EF Core には最新バージョンの .NET が必要です。 使用する EF Core のバージョンに必要な最小限の .NET バージョンについては、EF Core リリースを参照してください。
EF Core を使用して、Visual Studio を使用して Windows 上でアプリケーションを開発できます。 Visual Studio の最新バージョンをお勧めします。
Entity Framework Core を取得する
EF Core は NuGet パッケージとして出荷されます。 EF Core をアプリケーションに追加するには、使用するデータベース プロバイダーの NuGet パッケージをインストールします。 使用可能 なデータベース プロバイダー の一覧については、「プロバイダー」を参照してください。
NuGet パッケージをインストールまたは更新するには、.NET コマンド ライン インターフェイス (CLI)、Visual Studio パッケージ マネージャー ダイアログ、または Visual Studio パッケージ マネージャー コンソールを使用できます。
.NET CLI
オペレーティング システムのコマンド ラインから次の .NET CLI コマンドを使用して、EF Core SQL Server プロバイダーをインストールまたは更新します。
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package
修飾子を使用して、-v
コマンドで特定のバージョンを指定できます。 たとえば、EF Core 6.0.14 パッケージをインストールするには、コマンドに-v 6.0.14
を追加します。
詳細については、 .NET コマンド ライン インターフェイス (CLI) ツールを参照してください。
Visual Studio NuGet パッケージ マネージャー ダイアログ
Visual Studio メニューの [プロジェクト] > [NuGet パッケージの管理] を選択します
[ 参照 ] タブまたは [ 更新プログラム ] タブをクリックします。
SQL Server プロバイダーをインストールまたは更新するには、
Microsoft.EntityFrameworkCore.SqlServer
パッケージを選択して確認します。
詳細については、「 NuGet パッケージ マネージャー ダイアログ」を参照してください。
Visual Studio NuGet パッケージ マネージャー コンソール
Visual Studio メニューから、[ツール] > [NuGet パッケージ マネージャー] > [パッケージ マネージャー コンソール] を選択します
SQL Server プロバイダーをインストールするには、パッケージ マネージャー コンソールで次のコマンドを実行します。
Install-Package Microsoft.EntityFrameworkCore.SqlServer
プロバイダーを更新するには、
Update-Package
コマンドを使用します。特定のバージョンを指定するには、
-Version
修飾子を使用します。 たとえば、EF Core 6.0.14 パッケージをインストールするには、コマンドに-Version 6.0.14
を追加します
詳細については、「 パッケージ マネージャー コンソール」を参照してください。
Entity Framework Core ツールを取得する
プロジェクトに EF Core 関連のタスクを実行するためのツール (データベース移行の作成と適用、既存のデータベースに基づく EF Core モデルの作成など) をインストールできます。
次の 2 つのツール セットを使用できます。
.NET コマンド ライン インターフェイス (CLI) ツールは、Windows、Linux、または macOS で使用できます。 これらのコマンドは、
dotnet ef
で始まります。パッケージ マネージャー コンソール (PMC) ツールは、Windows 上の Visual Studio で実行されます。 これらのコマンドは、
Add-Migration
、Update-Database
などの動詞で始まります。
.NET CLI ツールを取得する
.NET CLI ツールには、「前提条件」で前述した .NET SDK が必要です。
dotnet ef
は、グローバル またはローカル ツールとしてインストールする必要があります。 ほとんどの開発者は、次のコマンドを使用して、dotnet ef
をグローバル ツールとしてインストールする方を選びます。dotnet tool install --global dotnet-ef
dotnet ef
をローカル ツールとして使用することもできます。 ローカル ツールとして使用するには、ツール マニフェスト ファイルを使用してツールの依存関係として宣言するプロジェクトの依存関係を復元します。ツールを更新するには、
dotnet tool update
コマンドを使用します。最新の
Microsoft.EntityFrameworkCore.Design
パッケージをインストールします。dotnet add package Microsoft.EntityFrameworkCore.Design
Important
ランタイム パッケージのメジャー バージョンに一致するツール パッケージのバージョンを常に使用します。
パッケージ マネージャー コンソール ツールを取得する
EF Core 用のパッケージ マネージャー コンソール ツールを取得するには、 Microsoft.EntityFrameworkCore.Tools
パッケージをインストールします。 たとえば、Visual Studio から:
Install-Package Microsoft.EntityFrameworkCore.Tools
最新の EF Core へのアップグレード
EF Core の新しいバージョンをリリースするたびに、Microsoft.EntityFrameworkCore.SqlServer、Microsoft.EntityFrameworkCore.Sqlite、Microsoft.EntityFrameworkCore.Cosmos、Microsoft.EntityFrameworkCore.InMemory など、EF Core プロジェクトの一部であるプロバイダーの新しいバージョンもリリースされます。 新しいバージョンのプロバイダーにアップグレードするだけで、すべての改善を得ることができます。
サード パーティのデータベース プロバイダーを使用しているアプリケーションを更新する必要がある場合は、使用する EF Core のバージョンと互換性のあるプロバイダーの更新プログラムを常に確認してください。 たとえば、バージョン 1.0 のデータベース プロバイダーは、EF Core ランタイムのバージョン 2.0 などと互換性がありません。
EF Core 用のサードパーティ プロバイダーは、通常、EF Core ランタイムと共にパッチ バージョンをリリースしません。 サード パーティのプロバイダーを使用するアプリケーションを EF Core のパッチ バージョンにアップグレードするには、個々の EF Core ランタイム コンポーネント (特に Microsoft.EntityFrameworkCore、および Microsoft.EntityFrameworkCore.Relational) への直接参照を追加する必要がある場合があります。
.NET