dotnet new

Cet article s’applique à : ✔️ le kit de développement logiciel (SDK) .net Core 2,0 et versions ultérieures

Nom

dotnet new : crée un projet, un fichier de configuration ou une solution en fonction du modèle spécifié.

Synopsis

dotnet new <TEMPLATE> [--dry-run] [--force] [-lang|--language {"C#"|"F#"|VB}]
    [-n|--name <OUTPUT_NAME>] [-o|--output <OUTPUT_DIRECTORY>] [Template options]

dotnet new -h|--help

Description

La dotnet new commande crée un projet .net ou d’autres artefacts basés sur un modèle.

La commande appelle le moteur de modèles pour créer les artefacts sur le disque en fonction du modèle et des options spécifiés.

Restauration implicite

Vous n’avez pas à exécuter dotnet restore , car il est exécuté implicitement par toutes les commandes qui nécessitent une restauration, comme,,,, dotnet new dotnet build dotnet run dotnet test dotnet publish et dotnet pack . Pour désactiver la restauration implicite, utilisez l' --no-restore option.

La dotnet restore commande est toujours utile dans certains scénarios où la restauration explicite est appropriée, comme les 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 où la restauration se produit.

Pour plus d’informations sur la gestion des flux NuGet, consultez la dotnet restore documentation.

Arguments

  • TEMPLATE

    Modèle à instancier quand la commande est appelée. Vous pouvez passer des options spécifiques pour chaque modèle. Pour plus d'informations, consultez Options de modèle.

    Vous pouvez exécuter dotnet new --list pour afficher la liste de tous les modèles installés.

    à compter du kit de développement logiciel (sdk) .net core 3,0 et se terminant par le kit sdk .net core 5.0.300, l’interface CLI recherche des modèles dans NuGet. org quand vous appelez la dotnet new commande dans les conditions suivantes :

    • Si l’interface CLI ne peut pas trouver de correspondance de modèle lors de l’appel dotnet new de, pas encore partiel.
    • Si une version plus récente du modèle est disponible. Dans ce cas, le projet ou l’artefact est créé, mais l’interface CLI vous avertit d’une version mise à jour du modèle.

    à compter du kit de développement logiciel (SDK) .net Core 5.0.300, l' --search option doit être utilisée pour rechercher des modèles dans NuGet. org.

    Le tableau suivant présente les modèles qui sont préinstallés avec le kit de développement logiciel (SDK) .NET. Le langage par défaut pour le modèle est indiqué entre crochets. Cliquez sur le lien nom abrégé pour afficher les options de modèle spécifiques.

Modèles Nom court Langage Étiquettes Introduit
Application console console [C#], F#, VB Communes/Console 1.0
Bibliothèque de classes classlib [C#], F#, VB Communes/Bibliothèque 1.0
Application WPF wpf [C#], VB Commun/WPF 3,0 (5,0 pour VB)
Bibliothèque de classes WPF wpflib [C#], VB Commun/WPF 3,0 (5,0 pour VB)
Bibliothèque de contrôles personnalisés WPF wpfcustomcontrollib [C#], VB Commun/WPF 3,0 (5,0 pour VB)
Bibliothèque de contrôles utilisateur WPF wpfusercontrollib [C#], VB Commun/WPF 3,0 (5,0 pour VB)
Windows Application Forms (WinForms) winforms [C#], VB Common/WinForms 3,0 (5,0 pour VB)
Windows Bibliothèque de classes Forms (WinForms) winformslib [C#], VB Common/WinForms 3,0 (5,0 pour VB)
Service Worker worker [C#] Commun/Worker/Web 3.0
Projet de test unitaire mstest [C#], F#, VB Test/MSTest 1.0
Projet de test NUnit 3 nunit [C#], F#, VB Test/NUnit 2.1.400
Élément de test NUnit 3 nunit-test [C#], F#, VB Test/NUnit 2.2
Projet de test xUnit xunit [C#], F#, VB Test/xUnit 1.0
Composant Razor razorcomponent [C#] Web/ASP.NET 3.0
Page Razor page [C#] Web/ASP.NET 2.0
ViewImports MVC viewimports [C#] Web/ASP.NET 2.0
ViewStart MVC viewstart [C#] Web/ASP.NET 2.0
Blazor Application serveur blazorserver [C#] InternetBlazor 3.0
BlazorWebAssemblyApplication blazorwasm [C#] InternetBlazor/WebAssembly 3.1.300
ASP.NET Core vide web [C#], F# Web/vides 1.0
Application web ASP.NET Core (Model-View-Controller) mvc [C#], F# Web/MVC 1.0
Application web ASP.NET Core webapp, razor [C#] Web/MVC/Razor Pages 2,2, 2,0
ASP.NET Core avec Angular angular [C#] Web/MVC/SPA 2.0
ASP.NET Core avec React.js react [C#] Web/MVC/SPA 2.0
ASP.NET Core avec React.js et Redux reactredux [C#] Web/MVC/SPA 2.0
Bibliothèque de classes Razor razorclasslib [C#] Web/Razor/Library/Bibliothèque de classes Razor 2.1
API web ASP.NET Core webapi [C#], F# Web/WebAPI 1.0
ASP.NET Core Service gRPC grpc [C#] Web/gRPC 3.0
fichier gitignore dotnet gitignore Config 3.0
fichier global.json globaljson Config 2.0
Configuration NuGet nugetconfig Config 1.0
Fichier manifeste de l’outil local dotnet tool-manifest Config 3.0
Configuration Web webconfig Config 1.0
Fichier solution sln Solution 1.0
Fichier de mémoire tampon de protocole proto Web/gRPC 3.0

Options

  • --dry-run

    Affiche un récapitulatif de ce qui se passerait si la commande donnée était exécutée (si cela donnerait lieu à la création d’un modèle). Disponible à partir du SDK .NET Core 2.2.

  • --force

    Force le contenu à être généré même s’il change les fichiers existants. Cela est obligatoire lorsque le modèle choisi remplace les fichiers existants dans le répertoire de sortie.

  • -?|-h|--help

    Affiche l’aide pour la commande. Elle peut être appelée pour la dotnet new commande elle-même ou pour n’importe quel modèle. Par exemple : dotnet new mvc --help.

  • -lang|--language {C#|F#|VB}

    Langage du modèle à créer. Le langage accepté diffère selon le modèle (voir les valeurs par défaut dans la section arguments). Non valide pour certains modèles.

    Notes

    Certains interpréteurs interprètent la commande # comme un caractère spécial. Dans ce cas, mettez la valeur du paramètre de langue entre guillemets. Par exemple : dotnet new console -lang "F#".

  • -n|--name <OUTPUT_NAME>

    Le nom de la sortie créée. Si aucun nom n’est spécifié, le nom du répertoire actif est utilisé.

  • -o|--output <OUTPUT_DIRECTORY>

    Emplacement où placer la sortie générée. L'emplacement par défaut est le répertoire actif.

Options de modèle

Des options supplémentaires peuvent être définies pour chaque modèle. Pour plus d’informations, consultez modèles par défaut dotnet new .net pour .

Exemples

  • Créez un projet d’application console C# :

    dotnet new console
    
  • Créez un projet d’application console F# dans le répertoire actif :

    dotnet new console --language "F#"
    
  • Créez un projet de bibliothèque de classes .NET Standard 2,0 dans le répertoire spécifié :

    dotnet new classlib --framework "netstandard2.0" -o MyLibrary
    
  • Créez un projet ASP.NET Core C# MVC dans le répertoire actif sans authentification :

    dotnet new mvc -au None
    
  • Créez un projet xUnit :

    dotnet new xunit
    
  • Créez un global.js dans le répertoire actif en définissant la version du kit de développement logiciel (SDK) sur 3.1.101 :

    dotnet new globaljson --sdk-version 3.1.101
    

Voir aussi