Referenční informace k nástrojům Entity Framework Core – .NET Core CLI

Nástroje rozhraní příkazového řádku (CLI) pro Entity Framework Core provádějí úlohy vývoje v době návrhu. Vytvářejí například migrace, používají migrace a generují kód pro model založený na existující databázi. Příkazy jsou rozšířením příkazu dotnet pro různé platformy, který je součástí sady .NET Core SDK. Tyto nástroje pracují s projekty .NET Core.

Při použití sady Visual Studio zvažte použití nástrojů konzoly Správce balíčků místo nástrojů rozhraní příkazového řádku. nástroje konzoly Správce balíčků automaticky:

• Funguje s aktuálním projektem vybraným v konzole Správce balíčků, aniž byste museli ručně přepínat adresáře.
• Po dokončení příkazu otevře soubory vygenerované příkazem.
• Poskytuje dokončování příkazů, parametrů, názvů projektů, typů kontextu a názvů migrace pomocí tabulátoru.

Instalace nástrojů

dotnet ef lze nainstalovat jako globální nebo místní nástroj. Většina vývojářů preferuje dotnet ef instalaci jako globální nástroj pomocí následujícího příkazu:

dotnet tool install --global dotnet-ef

Pokud ho chcete použít jako místní nástroj, obnovte závislosti projektu, které ho deklarují jako závislost nástrojů pomocí souboru manifestu nástroje.

Aktualizujte nástroj pomocí následujícího příkazu:

dotnet tool update --global dotnet-ef

Než budete moct použít nástroje pro konkrétní projekt, budete do něj muset přidat Microsoft.EntityFrameworkCore.Design balíček.

dotnet add package Microsoft.EntityFrameworkCore.Design

Ověření instalace

Spuštěním následujících příkazů ověřte, že jsou správně nainstalované nástroje rozhraní příkazového řádku EF Core:

dotnet ef

Výstup příkazu identifikuje verzi nástrojů, které se používají:

                     _/\__
               ---==/    \\
         ___  ___   |.    \|\
        | __|| __|  |  )   \\\
        | _| | _|   \_/ |  //|\\
        |___||_|       /   \\\/\\

Entity Framework Core .NET Command-line Tools 2.1.3-rtm-32065

<Usage documentation follows, not shown.>

Aktualizace nástrojů

Slouží dotnet tool update --global dotnet-ef k aktualizaci globálních nástrojů na nejnovější dostupnou verzi. Pokud máte nástroje nainstalované místně v projektu, použijte dotnet tool update dotnet-ef. Nainstalujte konkrétní verzi připojením --version <VERSION> k příkazu. Další podrobnosti najdete v části Aktualizace v dokumentaci nástroje dotnet.

Použití nástrojů

Před použitím nástrojů možná budete muset vytvořit spouštěný projekt nebo nastavit prostředí.

Cílový projekt a spouštěný projekt

Příkazy odkazují na projekt a spouštěný projekt.

• Projekt se také označuje jako cílový projekt, protože příkazy přidávají nebo odebírají soubory. Ve výchozím nastavení je projekt v aktuálním adresáři cílovým projektem. Pomocí této možnosti můžete zadat jiný projekt jako cílový projekt --project .

• Spouštěcí projekt je projekt , který nástroje sestavují a spouštějí. Nástroje musí v době návrhu spouštět kód aplikace, aby získaly informace o projektu, jako je například databáze připojovací řetězec a konfigurace modelu. Ve výchozím nastavení je projekt v aktuálním adresáři spouštěný projekt. Pomocí této možnosti můžete zadat jiný projekt jako spouštěný projekt --startup-project .

Projekt po spuštění a cílový projekt jsou často stejný projekt. Typický scénář, ve kterém jsou samostatné projekty, jsou v následujících případech:

• Kontext EF Core a třídy entit jsou v knihovně tříd .NET Core.
• Konzolová aplikace .NET Core nebo webová aplikace odkazuje na knihovnu tříd.

Je také možné vložit kód migrace do knihovny tříd odděleně od kontextu EF Core.

Další cílové architektury

Nástroje rozhraní příkazového řádku pracují s projekty .NET Core a projekty rozhraní .NET Framework. Aplikace, které mají model EF Core v knihovně tříd .NET Standard, nemusí mít projekt .NET Core nebo .NET Framework. To platí například pro Xamarin a Univerzální platforma Windows aplikace. V takových případech můžete vytvořit projekt konzolové aplikace .NET Core, jehož jediným účelem je jednat jako spouštěný projekt pro nástroje. Projekt může být fiktivní projekt bez skutečného kódu – stačí zadat cíl pro nástroje.

Proč se vyžaduje fiktivní projekt? Jak už bylo zmíněno dříve, nástroje musí v době návrhu spouštět kód aplikace. K tomu musí použít modul runtime .NET Core. Pokud je model EF Core v projektu, který cílí na .NET Core nebo .NET Framework, nástroje EF Core si modul runtime půjčí z projektu. Nemůžou to udělat, pokud je model EF Core v knihovně tříd .NET Standard. .NET Standard není skutečná implementace .NET; jedná se o specifikaci sady rozhraní API, která musí implementace .NET podporovat. Proto .NET Standard nestačí pro nástroje EF Core ke spuštění kódu aplikace. Fiktivní projekt, který vytvoříte pro použití jako spouštěný projekt, poskytuje konkrétní cílovou platformu, do které mohou nástroje načíst knihovnu tříd .NET Standard.

prostředí ASP.NET Core

Na příkazovém řádku můžete zadat prostředí pro projekty ASP.NET Core. Tyto a všechny další argumenty jsou předány do Program.CreateHostBuilder.

dotnet ef database update -- --environment Production

Běžné možnosti

Do aplikace se předají všechny další argumenty.

dotnet ef database drop

Odstraní databázi.

Možnosti:

Běžné možnosti jsou uvedené výše.

dotnet ef database update

Aktualizace databázi k poslední migraci nebo k zadané migraci.

Argumenty:

Možnosti:

Běžné možnosti jsou uvedené výše.

Následující příklady aktualizují databázi na zadanou migraci. První použije název migrace a druhý použije ID migrace a zadané připojení:

dotnet ef database update InitialCreate
dotnet ef database update 20180904195021_InitialCreate --connection your_connection_string

dotnet ef dbcontext info

Získá informace o DbContext typu.

Běžné možnosti jsou uvedené výše.

dotnet ef dbcontext list

Seznam dostupných DbContext typů.

Běžné možnosti jsou uvedené výše.

dotnet ef dbcontext optimize

Vygeneruje zkompilovanou verzi modelu, který DbContextpoužívá .

Další informace najdete v tématu Kompilované modely .

Možnosti:

Běžné možnosti jsou uvedené výše.

Následující příklad používá výchozí nastavení a funguje, pokud je v projektu pouze jeden DbContext :

dotnet ef dbcontext optimize

Následující příklad optimalizuje model pro kontext se zadaným názvem a umístí ho do samostatné složky a oboru názvů:

dotnet ef dbcontext optimize -o Models -n BlogModels -c BlogContext

dotnet ef dbcontext scaffold

Generuje kód pro DbContext typy entit a pro databázi. Aby tento příkaz mohl vygenerovat typ entity, musí mít tabulka databáze primární klíč.

Argumenty:

Možnosti:

Běžné možnosti jsou uvedené výše.

Následující příklad vygeneruje všechna schémata a tabulky a umístí nové soubory do složky Models .

dotnet ef dbcontext scaffold "Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer -o Models

Následující příklad vygeneruje pouze vybrané tabulky a vytvoří kontext v samostatné složce se zadaným názvem a oborem názvů:

dotnet ef dbcontext scaffold "Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer -o Models -t Blog -t Post --context-dir Context -c BlogContext --context-namespace New.Namespace

Následující příklad načte připojovací řetězec ze sady konfigurace projektu pomocí nástroje Secret Manager.

dotnet user-secrets set ConnectionStrings:Blogging "Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=Blogging"
dotnet ef dbcontext scaffold Name=ConnectionStrings:Blogging Microsoft.EntityFrameworkCore.SqlServer

Následující příklad přeskočí generování OnConfiguring metody. To může být užitečné, když chcete nakonfigurovat DbContext mimo třídu. Například aplikace ASP.NET Core ji obvykle konfigurují ve službě Startup.ConfigureServices.

dotnet ef dbcontext scaffold "Server=(localdb)\mssqllocaldb;Database=Blogging;User Id=myUsername;Password=myPassword;" Microsoft.EntityFrameworkCore.SqlServer --no-onconfiguring

dotnet ef dbcontext script

Vygeneruje skript SQL z DbContext. Obchází všechny migrace.

Možnosti:

Běžné možnosti jsou uvedené výše.

dotnet ef migrations add

Přidá novou migraci.

Argumenty:

Možnosti:

Běžné možnosti jsou uvedené výše.

dotnet ef migrations bundle

Vytvoří spustitelný soubor pro aktualizaci databáze.

Možnosti:

Běžné možnosti jsou uvedené výše.

dotnet ef migrations has-pending-model-changes

Zkontroluje, jestli od poslední migrace nedošlo k nějakým změnám modelu.

Možnosti:

Běžné možnosti jsou uvedené výše.

dotnet ef migrations list

Zobrazí seznam dostupných migrací.

Možnosti:

Běžné možnosti jsou uvedené výše.

dotnet ef migrations remove

Odebere poslední migraci a vrátí zpět změny kódu, které byly provedeny pro nejnovější migraci.

Možnosti:

Běžné možnosti jsou uvedené výše.

dotnet ef migrations script

Generuje skript SQL z migrací.

Argumenty:

Možnosti:

Běžné možnosti jsou uvedené výše.

Následující příklad vytvoří skript pro migraci InitialCreate:

dotnet ef migrations script 0 InitialCreate

Následující příklad vytvoří skript pro všechny migrace po migraci InitialCreate.

dotnet ef migrations script 20180904195021_InitialCreate

Další prostředky

• Migrace
• Zpětná analýza
• Kompilované modely