次の方法で共有


Entity Framework Core のインストール

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 ツールを取得する

.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.CosmosMicrosoft.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) への直接参照を追加する必要がある場合があります。