Outils de la Console Gestionnaire de Package EF CoreEF Core Package Manager Console Tools

Les outils Entity Framework Core Package Manager Console (PMC) est exécuté à l’intérieur de Visual Studio à l’aide de NuGet Console du Gestionnaire de Package.The EF Core Package Manager Console (PMC) Tools run inside of Visual Studio using NuGet's Package Manager Console. Ces outils fonctionnent avec les projets .NET Framework et .NET Core.These tools work with both .NET Framework and .NET Core projects.

Conseil

N’utilisez ne pas Visual Studio ?Not using Visual Studio? Le [outils de ligne de commande de EF Core] 1 sont multiplateformes et d’exécution à l’intérieur d’une invite de commandes.The EF Core Command-line Tools are cross-platform and run inside a command prompt.

Installation des outilsInstalling the tools

Installer les outils de Console du Gestionnaire de Package EF Core en installant le package NuGet de Microsoft.EntityFrameworkCore.Tools.Install the EF Core Package Manager Console Tools by installing the Microsoft.EntityFrameworkCore.Tools NuGet package. Vous pouvez l’installer en exécutant la commande suivante à l’intérieur de Console du Gestionnaire de Package.You can install it by executing the following command inside Package Manager Console.

Install-Package Microsoft.EntityFrameworkCore.Tools

Si tout fonctionne correctement, vous devez être en mesure d’exécuter cette commande :If everything worked correctly, you should be able to run this command:

Get-Help about_EntityFrameworkCore

Conseil

Si votre projet de démarrage cible .NET Standard, [un framework pris en charge de ciblage croisé] 3 avant d’utiliser les outils.If your startup project targets .NET Standard, cross-target a supported framework before using the tools.

Important

Si vous utilisez Windows universel ou Xamarin, déplacer votre code EF vers une bibliothèque de classes .NET Standard et [un framework pris en charge de ciblage croisé] 3 avant d’utiliser les outils.If you're using Universal Windows or Xamarin, move your EF code to a .NET Standard class library and cross-target a supported framework before using the tools. Spécifier la bibliothèque de classes en tant que projet de démarrage.Specify the class library as your startup project.

L’utilisation des outilsUsing the tools

Chaque fois que vous appelez une commande, deux projets sont impliqués :Whenever you invoke a command, there are two projects involved:

Le projet cible contient les fichiers qui sont ajoutés (ou dans certains cas supprimés).The target project is where any files are added (or in some cases removed). Le projet cible par défaut est le projet par défaut sélectionné dans la Console du Gestionnaire de Package, mais peut également être spécifié à l’aide de-paramètre du projet.The target project defaults to the Default project selected in Package Manager Console, but can also be specified using the -Project parameter.

Le projet de démarrage est le projet qu’émulent les outils durant l’exécution du code de votre projet.The startup project is the one emulated by the tools when executing your project's code. Les valeurs par défaut une définir comme projet de démarrage dans l’Explorateur de solutions.It defaults to one Set as StartUp Project in Solution Explorer. Il peut également être spécifié en utilisant le paramètre - StartupProject.It can also be specified using the -StartupProject parameter.

Paramètres communs :Common parameters:

-Contexte <chaîne >-Context <String> DbContext à utiliser.The DbContext to use.
-Projet <chaîne >-Project <String> Le projet à utiliser.The project to use.
-StartupProject <chaîne >-StartupProject <String> Le projet de démarrage à utiliser.The startup project to use.
-Verbose-Verbose Afficher la sortie détaillée.Show verbose output.

Pour afficher les informations d’aide sur une commande, utilisez PowerShell Get-Help commande.To show help information about a command, use PowerShell's Get-Help command.

Conseil

Les paramètres de contexte, le projet et StartupProject prend en charge d’extension de l’onglet.The Context, Project, and StartupProject parameters support tab-expansion.

Conseil

Définissez env:ASPNETCORE_ENVIRONMENT avant d’exécuter pour spécifier l’environnement ASP.NET Core.Set env:ASPNETCORE_ENVIRONMENT before running to specify the ASP.NET Core environment.

CommandesCommands

Add-MigrationAdd-Migration

Ajoute une nouvelle migration.Adds a new migration.

Paramètres :Parameters:

-Name <chaîne >-Name <String> Le nom de la migration.The name of the migration.
-OutputDir <chaîne >-OutputDir <String> Le répertoire (et espace de noms secondaire) à utiliser.The directory (and sub-namespace) to use. Chemins d’accès sont relatif au répertoire de projet.Paths are relative to the project directory. La valeur par défaut est « Migrations ».Defaults to "Migrations".

Note

Paramètres dans gras sont nécessaires et celles dans italique sont positionnels.Parameters in bold are required, and ones in italics are positional.

DROP DatabaseDrop-Database

Supprime la base de données.Drops the database.

Paramètres :Parameters:

-WhatIf-WhatIf Afficher la base de données serait supprimée, mais ne la supprimez.Show which database would be dropped, but don't drop it.

Get-DbContextGet-DbContext

Obtient des informations sur un type DbContext.Gets information about a DbContext type.

Remove-MigrationRemove-Migration

Supprime la dernière migration.Removes the last migration.

Paramètres :Parameters:

-Force-Force Rétablir la migration s’il a été appliqué à la base de données.Revert the migration if it has been applied to the database.

Scaffold-DbContextScaffold-DbContext

Permet de générer automatiquement un types DbContext et d’entité pour une base de données.Scaffolds a DbContext and entity types for a database.

Paramètres :Parameters:

-Connexion <chaîne >-Connection <String> La chaîne de connexion à la base de données.The connection string to the database.
-Fournisseur <chaîne >-Provider <String> Le fournisseur à utiliser.The provider to use. (par exemple, Microsoft.EntityFrameworkCore.SqlServer)(for example, Microsoft.EntityFrameworkCore.SqlServer)
-OutputDir <chaîne >-OutputDir <String> Répertoire à placer les fichiers dans.The directory to put files in. Chemins d’accès sont relatif au répertoire de projet.Paths are relative to the project directory.
-ContextDir <chaîne >-ContextDir <String> Le répertoire de placer le fichier de DbContext dans.The directory to put DbContext file in. Chemins d’accès sont relatif au répertoire de projet.Paths are relative to the project directory.
-Contexte <chaîne >-Context <String> Le nom de la classe DbContext pour générer.The name of the DbContext to generate.
-Schémas <String [] >-Schemas <String[]> Les schémas des tables pour générer des types d’entité.The schemas of tables to generate entity types for.
-Tables <String [] >-Tables <String[]> Les tables pour générer des types d’entité.The tables to generate entity types for.
-DataAnnotations-DataAnnotations Utilisez des attributs pour configurer le modèle (le cas échéant).Use attributes to configure the model (where possible). Si omis, uniquement l’API fluent est utilisé.If omitted, only the fluent API is used.
-UseDatabaseNames-UseDatabaseNames Utilisez des noms de table et de colonne directement à partir de la base de données.Use table and column names directly from the database.
-Force-Force Remplacer les fichiers existants.Overwrite existing files.

Migration de scriptScript-Migration

Génère un script SQL à partir de migrations.Generates a SQL script from migrations.

Paramètres :Parameters:

-From <chaîne >-From <String> La migration de départ.The starting migration. La valeur par défaut est 0 (la base de données initiale).Defaults to 0 (the initial database).
- <Chaîne >-To <String> La migration de fin.The ending migration. Valeur par défaut est la dernière migration.Defaults to the last migration.
-Idempotent-Idempotent Générer un script qui peut être utilisé sur toute migration d’une base de données.Generate a script that can be used on a database at any migration.
-Sortie <chaîne >-Output <String> Fichier dans lequel écrire le résultat.The file to write the result to.

Conseil

To, From, et les paramètres de sortie prend en charge d’extension de l’onglet.The To, From, and Output parameters support tab-expansion.

Mise à jour la base de donnéesUpdate-Database

-Migration <chaîne >-Migration <String> La migration de la cible.The target migration. Si '0', toutes les migrations seront annulées.If '0', all migrations will be reverted. Valeur par défaut est la dernière migration.Defaults to the last migration.

Conseil

Le paramètre de Migration prend en charge d’extension de l’onglet.The Migration parameter supports tab-expansion.