dotnet rundotnet run

Cet article s’applique à: ✔️ .NET Core 2.x SDK et les versions ultérieuresThis article applies to: ✔️ .NET Core 2.x SDK and later versions

NomName

dotnet run - Exécute le code source sans commandes explicites de compilation ou de démarrage.dotnet run - Runs source code without any explicit compile or launch commands.

SynopsisSynopsis

dotnet run [-c|--configuration] [-f|--framework] [--force] [--interactive] [--launch-profile]
    [--no-build] [--no-dependencies] [--no-launch-profile] [--no-restore] [-p|--project]
    [-r|--runtime] [-v|--verbosity] [[--] [application arguments]]
dotnet run [-h|--help]

DescriptionDescription

La commande dotnet run fournit une option pratique pour exécuter votre application à partir du code source à l’aide d’une seule commande.The dotnet run command provides a convenient option to run your application from the source code with one command. Elle est utile pour le développement itératif rapide en ligne de commande.It's useful for fast iterative development from the command line. La commande dépend dotnet build de la commande pour construire le code.The command depends on the dotnet build command to build the code. Les conditions requises pour la génération, par exemple le fait que le projet doit être restauré en premier, s’appliquent également à dotnet run.Any requirements for the build, such as that the project must be restored first, apply to dotnet run as well.

Les fichiers de sortie sont écrits dans l’emplacement par défaut, à savoir bin/<configuration>/<target>.Output files are written into the default location, which is bin/<configuration>/<target>. Par exemple, si vous avez une application netcoreapp2.1 et que vous exécutez dotnet run, la sortie est placée dans bin/Debug/netcoreapp2.1.For example if you have a netcoreapp2.1 application and you run dotnet run, the output is placed in bin/Debug/netcoreapp2.1. Les fichiers sont remplacés, si nécessaire.Files are overwritten as needed. Les fichiers temporaires sont placés dans le répertoire obj.Temporary files are placed in the obj directory.

Si le projet spécifie plusieurs frameworks, l’exécution de dotnet run entraîne une erreur, sauf si l’option -f|--framework <FRAMEWORK> est utilisée pour spécifier le framework.If the project specifies multiple frameworks, executing dotnet run results in an error unless the -f|--framework <FRAMEWORK> option is used to specify the framework.

La commande dotnet run est utilisée pour des projets, et pas pour des assemblys générés.The dotnet run command is used in the context of projects, not built assemblies. Si vous tentez d’exécuter plutôt une DLL d’applications dépendantes du framework, vous devez utiliser dotnet sans commande.If you're trying to run a framework-dependent application DLL instead, you must use dotnet without a command. Par exemple, pour exécuter myapp.dll, utilisez :For example, to run myapp.dll, use:

dotnet myapp.dll

Pour plus d’informations sur le pilote dotnet, consultez la rubrique Outils en ligne de commande (CLI) .NET Core.For more information on the dotnet driver, see the .NET Core Command Line Tools (CLI) topic.

Pour exécuter l’application, la commande dotnet run résout les dépendances de l’application externes au runtime partagé à partir du cache NuGet.To run the application, the dotnet run command resolves the dependencies of the application that are outside of the shared runtime from the NuGet cache. Dans la mesure où elle utilise la mise en cache des dépendances, il n’est pas recommandé d’utiliser dotnet run pour exécuter des applications en production.Because it uses cached dependencies, it's not recommended to use dotnet run to run applications in production. Créez plutôt un déploiement à l’aide de la commande dotnet publish et déployez le résultat publié.Instead, create a deployment using the dotnet publish command and deploy the published output.

Notes

En commençant par .NET Core 2.0, dotnet restore vous n’avez pas à courir parce qu’il est dotnet build exécuté dotnet runimplicitement par toutes les commandes qui nécessitent une restauration pour se produire, tels que et .Starting with .NET Core 2.0, you don't have to run dotnet restore because it's run implicitly by all commands that require a restore to occur, such as dotnet build and dotnet run. Cette commande reste néanmoins valide dans certains scénarios où une restauration explicite est nécessaire, comme des builds d’intégration continue dans Azure DevOps Services ou dans les systèmes de génération qui doivent contrôler explicitement le moment auquel la restauration se produit.It's still a valid command in certain scenarios where doing an explicit restore makes sense, such as continuous integration builds in Azure DevOps Services or in build systems that need to explicitly control the time at which the restore occurs.

Cette commande prend également en charge les options de dotnet restore quand elles sont passées sous leur forme longue (par exemple --source).This command also supports the dotnet restore options when passed in the long form (for example, --source). Les options sous forme abrégée, comme -s, ne sont pas prises en charge.Short form options, such as -s, are not supported.

OptionsOptions

  • --

    Délimite les arguments à dotnet run parmi les arguments de l’application en cours d’exécution.Delimits arguments to dotnet run from arguments for the application being run. Tous les arguments après ce délimiteur sont passés à l’application exécutée.All arguments after this delimiter are passed to the application run.

  • -c|--configuration <CONFIGURATION>

    Définit la configuration de build.Defines the build configuration. La valeur par Debugdéfaut pour la plupart des projets est, mais vous pouvez remplacer les paramètres de configuration de construction dans votre projet.The default for most projects is Debug, but you can override the build configuration settings in your project.

  • -f|--framework <FRAMEWORK>

    Crée et exécute l’application à l’aide du framework spécifié.Builds and runs the app using the specified framework. Le framework doit être spécifié dans le fichier projet.The framework must be specified in the project file.

  • --force

    Force la résolution de toutes les dépendances même si la dernière restauration a réussi.Forces all dependencies to be resolved even if the last restore was successful. Définir cet indicateur revient à supprimer le fichier project.assets.json.Specifying this flag is the same as deleting the project.assets.json file.

  • -h|--help

    Affiche une aide brève pour la commande.Prints out a short help for the command.

  • --interactive

    Permet à la commande de s’arrêter et d’attendre une saisie ou une action de l’utilisateur (son authentification, par exemple).Allows the command to stop and wait for user input or action (for example, to complete authentication). Option disponible à partir du kit SDK .NET Core 3.0.Available since .NET Core 3.0 SDK.

  • --launch-profile <NAME>

    Nom du profil de lancement éventuel à utiliser au lancement de l’application.The name of the launch profile (if any) to use when launching the application. Les profils de lancement sont définis dans le fichier Development launchSettings.json et sont généralement appelés , Staging, et Production.Launch profiles are defined in the launchSettings.json file and are typically called Development, Staging, and Production. Pour plus d’informations, voir Travailler avec plusieurs environnements.For more information, see Working with multiple environments.

  • --no-build

    Ne génère pas le projet avant l’exécution.Doesn't build the project before running. L’indicateur --no-restore est également défini implicitement.It also implicit sets the --no-restore flag.

  • --no-dependencies

    En cas de restauration d’un projet avec des références entre projets (P2P), restaure le projet racine et non les références.When restoring a project with project-to-project (P2P) references, restores the root project and not the references.

  • --no-launch-profile

    N’essaie pas d’utiliser launchSettings.json pour configurer l’application.Doesn't try to use launchSettings.json to configure the application.

  • --no-restore

    N’effectue pas de restauration implicite à l’exécution de la commande.Doesn't execute an implicit restore when running the command.

  • -p|--project <PATH>

    Spécifie le chemin du fichier projet à exécuter (nom de dossier ou chemin complet).Specifies the path of the project file to run (folder name or full path). Si aucune valeur n’est spécifiée, le répertoire actif est utilisé par défaut.If not specified, it defaults to the current directory.

  • -r|--runtime <RUNTIME_IDENTIFIER>

    Spécifie le runtime cible pour lequel restaurer les packages.Specifies the target runtime to restore packages for. Pour connaître les identificateurs de runtime, consultez le catalogue des identificateurs de runtime.For a list of Runtime Identifiers (RIDs), see the RID catalog. -roption courte disponible depuis .NET Core 3.0 SDK.-r short option available since .NET Core 3.0 SDK.

  • -v|--verbosity <LEVEL>

    Définit le niveau de détail de la commande.Sets the verbosity level of the command. Les valeurs autorisées sont q[uiet], m[inimal], n[ormal], d[etailed] et diag[nostic].Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic]. La valeur par défaut est m.The default value is m. Disponible depuis .NET Core 2.1 SDK.Available since .NET Core 2.1 SDK.

ExemplesExamples

  • Exécutez le projet dans le répertoire actif :Run the project in the current directory:

    dotnet run
    
  • Exécutez le projet spécifié :Run the specified project:

    dotnet run --project ./projects/proj1/proj1.csproj
    
  • Exécutez le projet dans le répertoire actuel (l’argument --help de cet exemple est passé à l’application, puisque l’option -- vide est utilisée) :Run the project in the current directory (the --help argument in this example is passed to the application, since the blank -- option is used):

    dotnet run --configuration Release -- --help
    
  • Restaurer des dépendances et des outils pour le projet dans le répertoire actuel en montrant uniquement une sortie minimale, puis exécuter le projet : (SDK .NET Core 2.0 et ultérieur) :Restore dependencies and tools for the project in the current directory only showing minimal output and then run the project: (.NET Core SDK 2.0 and later versions):

    dotnet run --verbosity m