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

Les outils EF Core Package Manager Console (PMC) est exécuté à l’intérieur de Visual Studio à l’aide de NuGet Package Manager Console.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 [EF principaux outils de ligne de commande] 1 sont inter-plateformes et s’exécutent à 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

Installez les outils de la Console Gestionnaire de Package de base EF 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 Package Manager Console.You can install it by executing the following command inside Package Manager Console.

Install-Package Microsoft.EntityFrameworkCore.Tools

Si tout fonctionne correctement, il se peut que 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, [cross-cible une infrastructure de prise en charge] 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 universelles ou Xamarin, déplacez votre code EF à une bibliothèque de classes .NET Standard et [cross-cible une infrastructure de prise en charge] 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écifiez 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, il existe deux projets concerné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 la 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. La valeur 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é à l’aide du 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 des commentaires.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, du projet et StartupProject prend en charge le développement par tabulation.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

Ajouter la 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 du projet.Paths are relative to the project directory. La valeur par défaut est « Migration ».Defaults to "Migrations".

Note

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

Déplacer la base de donnéesDrop-Database

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

Paramètres :Parameters:

-WhatIf-WhatIf Afficher la base de données qui seront supprimés, mais ne pas supprimer.Show which database would be dropped, but don't drop it.

Get-DbContextGet-DbContext

Obtient des informations sur un type de 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 si elle a été appliquée à la base de données.Revert the migration if it has been applied to the database.

Scaffold-DbContextScaffold-DbContext

Structures un types DbContext et l’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 ex.(E.g. Microsoft.EntityFrameworkCore.SqlServer)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 du projet.Paths are relative to the project directory.
-ContextDir <chaîne >-ContextDir <String> Répertoire à placer dans DbContext.The directory to put DbContext file in. Chemins d’accès sont relatif au répertoire du projet.Paths are relative to the project directory.
-Contexte <chaîne >-Context <String> Le nom de la DbContext à 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és.The schemas of tables to generate entity types for.
-Tables <String [] >-Tables <String[]> Les tables pour générer des types d’entités.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 la migration.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 (base de données initiale).Defaults to 0 (the initial database).
- <Chaîne >-To <String> La fin de la migration.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, une base de données.Generate a script that can be used on a database at any migration.
-Sortie <chaîne >-Output <String> Le 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 le développement par tabulation.The To, From, and Output parameters support tab-expansion.

Base de données de mise à jourUpdate-Database

-Migration <chaîne >-Migration <String> La migration de cible.The target migration. Si 0, toutes les migrations vont être 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 la Migration prend en charge le développement par tabulation.The Migration parameter supports tab-expansion.