Partager via

Modèles .NET par défaut pour dotnet new

  • Article

Quand vous installez le SDK .NET Core, vous obtenez plus d’une dizaine de modèles intégrés pour créer des projets et des fichiers, notamment des applications de console, des bibliothèques de classes, des projets de test unitaire, des applications ASP.NET Core (dont les projets Angular et React) et des fichiers de configuration. Pour répertorier les modèles intégrés, exécutez la commande dotnet new list :

dotnet new list

Le tableau suivant présente les modèles préinstallés avec le SDK .NET. Le langage par défaut pour le modèle est indiqué entre crochets. Cliquez sur le lien du nom court pour voir les options spécifiques au modèle.

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 Common/WPF 3.0 (5.0 pour VB)
Bibliothèque de classes WPF wpflib [C#], VB Common/WPF 3.0 (5.0 pour VB)
Bibliothèque de contrôles personnalisés WPF wpfcustomcontrollib [C#], VB Common/WPF 3.0 (5.0 pour VB)
Bibliothèque de contrôles utilisateur WPF wpfusercontrollib [C#], VB Common/WPF 3.0 (5.0 pour VB)
Application Windows Forms (WinForms) winforms [C#], VB Common/WinForms 3.0 (5.0 pour VB)
Bibliothèque de classes Windows Forms (WinForms) winformslib [C#], VB Common/WinForms 3.0 (5.0 pour VB)
Service Worker worker [C#] Common/Worker/Web 3.0
Projet de test MSTest mstest [C#], F#, VB Test/MSTest 1.0
MsTest Test, classe mstest-class [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
Razor composants 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
Application webBlazor blazor [C#] Web/Blazor 8.0.100
BlazorWebAssembly Application autonome blazorwasm [C#] Web/BlazorWebAssemblyPWA 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
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/Web API/API/Service/WebAPI 1.0
API ASP.NET Core webapiaot [C#] Web/Web API/API/Service 8.0
contrôleur d’API core ASP.NET apicontroller [C#] Web/ASP.NET 8.0
Service gRPC ASP.NET Core grpc [C#] Web/gRPC 3.0
fichier dotnet gitignore 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 tampon de protocole proto Web/gRPC 3.0
Fichier EditorConfig editorconfig Config 6.0

Le tableau suivant présente les modèles qui ont été supprimés et qui ne sont plus préinstallés avec le Kit de développement logiciel (SDK) .NET. Cliquez sur le lien du nom court pour voir les options spécifiques au modèle.

Modèles Nom court Langage Balises Arrêté depuis
ASP.NET Core avec Angular angular [C#] Web/MVC/SPA 8.0
ASP.NET Core avec React.js react [C#] Web/MVC/SPA 8.0
Blazor Application serveur blazorserver [C#] Web/Blazor 8.0
Blazor Application serveur vide blazorserver-empty [C#] Web/Blazor 8.0
BlazorWebAssembly Application vide blazorwasm-empty [C#] Web/Blazor/WebAssembly 8.0

Options de modèle

Chaque modèle peut avoir des options supplémentaires disponibles. Pour afficher les options supplémentaires disponibles pour le modèle, utilisez l’option --help avec l’argument nom du modèle, par exemple : dotnet new console --help. Si le modèle prend en charge plusieurs langues, cette commande affichera l’aide du modèle dans la langue par défaut. En la combinant avec l’option --language , vous pouvez voir l’aide pour d’autres langues : dotnet new console --help --language F#. Les modèles fournis avec le Kit de développement logiciel (SDK) .NET disposent des options supplémentaires suivantes :

console

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler. Option disponible à partir du kit SDK .NET Core 3.0.

    Le tableau suivant répertorie les valeurs par défaut en fonction de la version du Kit de développement logiciel (SDK) que vous utilisez :

    Version du SDK Valeur par défaut
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    3.1 netcoreapp3.1

    La possibilité de créer un projet pour un module TFM antérieur dépend de l’installation de cette version du Kit de développement logiciel (SDK). Par exemple, si vous n’avez installé que le Kit de développement logiciel (SDK) .NET 7, la seule valeur disponible pour --framework est net7.0. Si vous installez le Kit de développement logiciel (SDK) .NET 6, la valeur net6.0 devient disponible pour --framework. Si vous installez le Kit de développement logiciel (SDK) .NET Core 3.1, netcoreapp3.1 devient disponible, et ainsi de suite. Par conséquent, en spécifiant --framework netcoreapp3.1, vous pouvez cibler .NET Core 3.1 même en exécutant dotnet new dans le Kit de développement logiciel (SDK) .NET 6.

    Vous pouvez également créer un projet qui cible un cadre antérieur au KIT de développement logiciel (SDK) que vous utilisez. Vous pouvez le faire en installant le package NuGet pour le modèle. Les types de projets courants, webet SPA utilisent différents packages par moniker de framework cible (TFM). Par exemple, pour créer un projet console qui cible netcoreapp1.0, exécuté dotnet new install sur Microsoft.DotNet.Common.ProjectTemplates.1.x.

  • --langVersion <VERSION_NUMBER>

    Définit la LangVersion propriété dans le fichier de projet créé. Par exemple, choisissez --langVersion 7.3 pour utiliser C# 7.3. Non pris en charge pour F#. Disponible à partir du SDK .NET Core 2.2.

    Pour obtenir la liste des versions C# par défaut, consultez Défauts.

  • --no-restore

    Si spécifié, ne pas exécuter une restauration implicite lors de la création du projet. Disponible à partir du SDK .NET Core 2.2.

  • --use-program-main

    Si spécifié, une Programclasse et Main une méthode explicites sont utilisées au lieu d’instructions de niveau supérieur. Disponible depuis le SDK .NET 6.0.300. Valeur par défaut : false. Disponible uniquement pour C#.

classlib

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler. Valeurs : net8.0, ou net7.0net6.0 pour créer une bibliothèque de classes .NET, ou netstandard2.1 netstandard2.0 pour créer une bibliothèque de classes .NET Standard. La valeur par défaut du kit de développement logiciel (SDK) .NET 8.0.x est net8.0.

    Pour créer un projet qui cible une infrastructure antérieure au Kit de développement logiciel (SDK) que vous utilisez, consultez --frameworkconsole les projets présentée plus haut dans cet article.

  • --langVersion <VERSION_NUMBER>

    Définit la LangVersion propriété dans le fichier de projet créé. Par exemple, choisissez --langVersion 7.3 pour utiliser C# 7.3. Non pris en charge pour F#. Disponible à partir du SDK .NET Core 2.2.

    Pour obtenir la liste des versions C# par défaut, consultez Défauts.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

wpf, , wpflibwpfcustomcontrollib, ,wpfusercontrollib

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler. Pour le SDK .NET 8, la valeur par défaut est net8.0. Disponible depuis le SDK .NET Core 3.1.

  • --langVersion <VERSION_NUMBER>

    Définit la LangVersion propriété dans le fichier de projet créé. Par exemple, choisissez --langVersion 7.3 pour utiliser C# 7.3.

    Pour obtenir la liste des versions C# par défaut, consultez Défauts.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

winforms, winformslib

  • --langVersion <VERSION_NUMBER>

    Définit la LangVersion propriété dans le fichier de projet créé. Par exemple, choisissez --langVersion 7.3 pour utiliser C# 7.3.

    Pour obtenir la liste des versions C# par défaut, consultez Défauts.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

worker, grpc

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler. La valeur par défaut du SDK .NET 8 est net8.0. Disponible depuis le SDK .NET Core 3.1.

    Pour créer un projet qui cible une infrastructure antérieure au Kit de développement logiciel (SDK) que vous utilisez, consultez --frameworkconsole les projets présentée plus haut dans cet article.

  • --exclude-launch-settings

    Exclut launchSettings.json du modèle généré.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

  • --use-program-main

    Si spécifié, une Programclasse et Main une méthode explicites sont utilisées au lieu d’instructions de niveau supérieur. Disponible depuis le SDK .NET 6.0.300. Valeur par défaut : false.

mstest

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler. Option disponible depuis le SDK .NET Core 3.0.

    Le tableau suivant répertorie les valeurs par défaut en fonction du numéro de version du Kit de développement logiciel (SDK) que vous utilisez :

    Version du SDK Valeur par défaut
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

La possibilité de créer un projet pour un module TFM antérieur dépend de l’installation de cette version du Kit de développement logiciel (SDK). Par exemple, si vous n’avez installé que le SDK .NET 6, alors la seule valeur disponible pour --framework est net6.0. Si vous installez le Kit de développement logiciel (SDK) .NET 5, la valeur net5.0 devient disponible pour --framework. Si vous installez le Kit de développement logiciel (SDK) .NET Core 3.1, netcoreapp3.1 devient disponible, et ainsi de suite. Par conséquent, en spécifiant --framework netcoreapp3.1, vous pouvez cibler .NET Core 3.1 même en exécutant dotnet new dans le Kit de développement logiciel (SDK) .NET 6.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

  • --sdk

    Utilisez le style de projet MSTest.Sdk.

  • --test-runner <TEST_RUNNER>

    Exécuteur/plateforme pour le projet de test. Les valeurs possibles sont les suivantes :

    • VSTest - Plateforme VSTest (par défaut).
    • MSTest - MSTest Runner (par exemple, Microsoft.Testing.Platform).

  • --coverage-tool <COVERAGE_TOOL>

    Outil de couverture à utiliser pour le projet de test. Les valeurs possibles sont les suivantes :

    • Microsoft.CodeCoverage - Couverture du code Microsoft (valeur par défaut).
    • coverlet - outil de couverture de couverture.

  • --extensions-profile <EXTENSIONS_PROFILE>

    Profil des extensions du Kit de développement logiciel (SDK) lors de l’utilisation de MSTest Runner. Les valeurs possibles sont les suivantes :

    • Default - Profil d’extensions par défaut (par défaut).
    • None - Aucune extension n’est activée.
    • AllMicrosoft - Active toutes les extensions fournies par Microsoft (y compris les extensions avec une licence restrictive).

  • --fixture <FIXTURE>

    Types de dispositifs à inclure dans le projet de test. Les valeurs possibles sont les suivantes :

    • None - Aucune méthode de montage.
    • AssemblyInitialize - Méthode assemblyInitialize fixture.
    • AssemblyCleanup - Méthode de montage AssemblyCleanup.
    • ClassInitialize - Méthode classInitialize fixture.
    • ClassCleanup - Méthode de montage ClassCleanup.
    • TestInitialize - Méthode testInitialize fixture.
    • TestCleanup - Méthode de montage TestCleanup.

    Où plusieurs valeurs sont autorisées.

  • -p|--enable-pack

    Permet l’empaquetage du projet à l’aide de dotnet pack.

mstest-class

  • --fixture <FIXTURE>

    Types de dispositifs à inclure dans le projet de test. Les valeurs possibles sont les suivantes :

    • None - Aucune méthode de montage.
    • AssemblyInitialize - Méthode assemblyInitialize fixture.
    • AssemblyCleanup - Méthode de montage AssemblyCleanup.
    • ClassInitialize - Méthode classInitialize fixture.
    • ClassCleanup - Méthode de montage ClassCleanup.
    • TestInitialize - Méthode testInitialize fixture.
    • TestCleanup - Méthode de montage TestCleanup.

    Où plusieurs valeurs sont autorisées.

xunit

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler. Option disponible depuis le SDK .NET Core 3.0.

    Le tableau suivant répertorie les valeurs par défaut en fonction du numéro de version du Kit de développement logiciel (SDK) que vous utilisez :

    Version du SDK Valeur par défaut
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

La possibilité de créer un projet pour un module TFM antérieur dépend de l’installation de cette version du Kit de développement logiciel (SDK). Par exemple, si vous n’avez installé que le SDK .NET 6, alors la seule valeur disponible pour --framework est net6.0. Si vous installez le Kit de développement logiciel (SDK) .NET 5, la valeur net5.0 devient disponible pour --framework. Si vous installez le Kit de développement logiciel (SDK) .NET Core 3.1, netcoreapp3.1 devient disponible, et ainsi de suite. Par conséquent, en spécifiant --framework netcoreapp3.1, vous pouvez cibler .NET Core 3.1 même en exécutant dotnet new dans le Kit de développement logiciel (SDK) .NET 6.

  • -p|--enable-pack

    Permet l’empaquetage du projet à l’aide de dotnet pack.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

nunit

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler.

    Le tableau suivant répertorie les valeurs par défaut en fonction du numéro de version du Kit de développement logiciel (SDK) que vous utilisez :

    Version du SDK Valeur par défaut
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

La possibilité de créer un projet pour un module TFM antérieur dépend de l’installation de cette version du Kit de développement logiciel (SDK). Par exemple, si vous n’avez installé que le SDK .NET 6, alors la seule valeur disponible pour --framework est net6.0. Si vous installez le Kit de développement logiciel (SDK) .NET 5, la valeur net5.0 devient disponible pour --framework. Si vous installez le Kit de développement logiciel (SDK) .NET Core 3.1, netcoreapp3.1 devient disponible, et ainsi de suite. Par conséquent, en spécifiant --framework netcoreapp3.1, vous pouvez cibler .NET Core 3.1 même en exécutant dotnet new dans le Kit de développement logiciel (SDK) .NET 6.

  • -p|--enable-pack

    Permet l’empaquetage du projet à l’aide de dotnet pack.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

page

  • -na|--namespace <NAMESPACE_NAME>

    Espace de noms pour le code généré. La valeur par défaut est MyApp.Namespace.

  • -np|--no-pagemodel

    Crée la page sans modèle de page.

viewimports, proto

  • -na|--namespace <NAMESPACE_NAME>

    Espace de noms pour le code généré. La valeur par défaut est MyApp.Namespace.

blazorserver

Supprimé depuis le Kit de développement logiciel (SDK) .NET 8.

  • -au|--auth <AUTHENTICATION_TYPE>

    Type d’authentification à utiliser. Les valeurs possibles sont les suivantes :

    • None : aucune authentification (configuration par défaut).
    • Individual : authentification individuelle.
    • IndividualB2C : authentification individuelle avec Azure AD B2C.
    • SingleOrg : authentification d’organisation pour un seul abonné. Les locataires ID externe Entra utilisent également SingleOrg.
    • MultiOrg : authentification d’organisation pour plusieurs abonnés.
    • Windows : authentification Windows.

  • --aad-b2c-instance <INSTANCE>

    L’instance d’Azure Active Directory B2C à laquelle se connecter. À utiliser avec l’authentification IndividualB2C. La valeur par défaut est https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    L’ID de la stratégie de connexion et d’inscription pour ce projet. À utiliser avec l’authentification IndividualB2C.

  • -rp|--reset-password-policy-id <ID>

    L’ID de stratégie de réinitialisation du mot de passe pour ce projet. À utiliser avec l’authentification IndividualB2C.

  • -ep|--edit-profile-policy-id <ID>

    L’ID de stratégie de modification du profil pour ce projet. À utiliser avec l’authentification IndividualB2C.

  • --aad-instance <INSTANCE>

    L’instance d’Azure Active Directory à laquelle se connecter. À utiliser avec l’authentification SingleOrg ou MultiOrg. La valeur par défaut est https://login.microsoftonline.com/.

  • --client-id <ID>

    L’ID client pour ce projet. À utiliser avec l’authentification IndividualB2C, SingleOrg ou MultiOrg. La valeur par défaut est 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Le domaine pour l’abonné d’annuaire. À utiliser avec l’authentification SingleOrg ou IndividualB2C. La valeur par défaut est qualified.domain.name.

  • --tenant-id <ID>

    L’ID d’abonné de l’annuaire auquel se connecter. À utiliser avec l’authentification SingleOrg. La valeur par défaut est 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Le chemin d’accès de la demande dans le chemin d’accès de base de l’application de l’URI de redirection. À utiliser avec l’authentification SingleOrg ou IndividualB2C. La valeur par défaut est /signin-oidc.

  • -r|--org-read-access

    Permet à cette application d’accéder en lecture au répertoire. S’applique uniquement à l’authentification SingleOrg ou MultiOrg.

  • --exclude-launch-settings

    Exclut launchSettings.json du modèle généré.

  • --no-https

    Désactive HTTPS. Cette option s’applique uniquement si Individual, IndividualB2C, SingleOrg ou MultiOrg ne sont pas utilisés pour --auth.

  • -uld|--use-local-db

    Spécifie que LocalDB doit être utilisé à la place de SQLite. S’applique uniquement à l’authentification Individual ou IndividualB2C.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

  • --kestrelHttpPort

    Numéro de port à utiliser pour le point de terminaison HTTP dans launchSettings.json.

  • --kestrelHttpsPort

    Numéro de port à utiliser pour le point de terminaison HTTPS dans launchSettings.json. Cette option n’est pas applicable lorsque le paramètre no-https est utilisé (mais no-https est ignoré lorsqu’un paramètre d’authentification individuelle ou organisationnelle est choisi pour --auth).

  • --use-program-main

    Si spécifié, une Programclasse et Main une méthode explicites sont utilisées au lieu d’instructions de niveau supérieur. Disponible depuis le SDK .NET 6.0.300. Valeur par défaut : false.

blazor

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler.

    Ce modèle est disponible pour les versions .NET 8 et ultérieures.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

  • --exclude-launch-settings

    Exclut launchSettings.json de l’application générée.

  • -int|--interactivity <None|Server|Webassembly|Auto >

    Spécifie le mode de rendu interactif à utiliser pour les composants interactifs. Les valeurs possibles sont les suivantes :

    • None : aucune interactivité (rendu statique côté serveur uniquement).
    • Server : (par défaut) exécute l’application sur le serveur avec un rendu interactif côté serveur.
    • WebAssembly : exécute l’application à l’aide d’un rendu côté client dans le navigateur avec WebAssembly.
    • Auto : utilise le rendu interactif côté serveur lors du téléchargement du pack Blazor et de l’activation du runtime Blazor sur le client, puis utilise le rendu côté client avec WebAssembly.

  • --empty

    Omet des exemples de pages et de style qui illustrent des modèles d’utilisation de base.

  • -au|--auth <AUTHENTICATION_TYPE>

    Type d’authentification à utiliser. Les valeurs possibles sont les suivantes :

    • None : aucune authentification (configuration par défaut).
    • Individual : authentification individuelle.

  • -uld|--use-local-db

    Spécifie que LocalDB doit être utilisé à la place de SQLite. S’applique uniquement à l’authentification Individual.

  • -ai|--all-interactive

    Rend chaque page interactive en appliquant un mode de rendu interactif au niveau supérieur. Si false, les pages utilisent par défaut le rendu statique côté serveur et peuvent être marquées comme interactives par page ou par composant. Cette option n’est efficace que si l’option -i|--interactivity n’est pas définie sur None.

  • --no-https

    Désactive HTTPS. Cette option s’applique uniquement si l’option Individual n’est pas choisie pour l’option -au|--auth.

  • --use-program-main

    Si elle est spécifiée, une classe Program et une méthode Main explicites sont utilisées au lieu des instructions de niveau supérieur.

blazorwasm

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler.

    Le tableau suivant répertorie les valeurs par défaut en fonction du numéro de version du Kit de développement logiciel (SDK) que vous utilisez :

    Version du SDK Valeur par défaut
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

    Pour créer un projet qui cible une infrastructure antérieure au Kit de développement logiciel (SDK) que vous utilisez, consultez --frameworkconsole les projets présentée plus haut dans cet article.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

  • -ho|--hosted

    Inclut un hôte ASP.NET Core pour l’application BlazorWebAssembly.

  • -au|--auth <AUTHENTICATION_TYPE>

    Type d’authentification à utiliser. Les valeurs possibles sont les suivantes :

    • None : aucune authentification (configuration par défaut).
    • Individual : authentification individuelle.
    • IndividualB2C : authentification individuelle avec Azure AD B2C.
    • SingleOrg : authentification d’organisation pour un seul abonné. Les locataires ID externe Microsoft Entra utilisent également SingleOrg.

  • --authority <AUTHORITY>

    L’autorité du fournisseur OIDC. À utiliser avec l’authentification Individual. La valeur par défaut est https://login.microsoftonline.com/.

  • --aad-b2c-instance <INSTANCE>

    L’instance d’Azure Active Directory B2C à laquelle se connecter. À utiliser avec l’authentification IndividualB2C. La valeur par défaut est https://aadB2CInstance.b2clogin.com/.

  • -ssp|--susi-policy-id <ID>

    L’ID de la stratégie de connexion et d’inscription pour ce projet. À utiliser avec l’authentification IndividualB2C.

  • --aad-instance <INSTANCE>

    L’instance d’Azure Active Directory à laquelle se connecter. À utiliser avec l’authentification SingleOrg. La valeur par défaut est https://login.microsoftonline.com/.

  • --client-id <ID>

    L’ID client pour ce projet. Utiliser avec IndividualB2C, SingleOrgou Individual l’authentification dans des scénarios autonomes. La valeur par défaut est 33333333-3333-3333-33333333333333333.

  • --domain <DOMAIN>

    Le domaine pour l’abonné d’annuaire. À utiliser avec l’authentification SingleOrg ou IndividualB2C. La valeur par défaut est qualified.domain.name.

  • --app-id-uri <URI>

    URI d’ID d’application pour le serveur API que vous souhaitez appeler. À utiliser avec l’authentification SingleOrg ou IndividualB2C. La valeur par défaut est api.id.uri.

  • --api-client-id <ID>

    L’ID client de l’API que le serveur héberge. À utiliser avec l’authentification SingleOrg ou IndividualB2C. La valeur par défaut est 11111111-1111-1111-11111111111111111.

  • -s|--default-scope <SCOPE>

    L’étendue de l’API que le client doit demander pour provisionner un jeton d’accès. À utiliser avec l’authentification SingleOrg ou IndividualB2C. La valeur par défaut est user_impersonation.

  • --tenant-id <ID>

    L’ID d’abonné de l’annuaire auquel se connecter. À utiliser avec l’authentification SingleOrg. La valeur par défaut est 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Permet à cette application d’accéder en lecture au répertoire. S’applique uniquement à l’authentification SingleOrg.

  • --exclude-launch-settings

    Exclut launchSettings.json du modèle généré.

  • -p|--pwa

    produit une application web progressive (PWA) prenant en charge l’installation et l’utilisation hors connexion.

  • --no-https

    Désactive HTTPS. Cette option s’applique uniquement si Individual, IndividualB2C, ou SingleOrg ne sont pas utilisés pour --auth.

  • -uld|--use-local-db

    Spécifie que LocalDB doit être utilisé à la place de SQLite. S’applique uniquement à l’authentification Individual ou IndividualB2C.

  • --called-api-url <URL>

    URL de l’API à appeler à partir de l’application web. S’applique uniquement à SingleOrg ou IndividualB2C l’authentification sans hôte ASP.NET Core spécifié. La valeur par défaut est https://graph.microsoft.com/v1.0/me.

  • --calls-graph

    Spécifie si l’application web appelle Microsoft Graph. S’applique uniquement à l’authentification SingleOrg.

  • --called-api-scopes <SCOPES>

    Étendues à demander pour appeler l’API depuis l’application web. S’applique uniquement à SingleOrg ou IndividualB2C l’authentification sans hôte ASP.NET Core spécifié. Par défaut, il s’agit de user.read.

  • --kestrelHttpPort

    Numéro de port à utiliser pour le point de terminaison HTTP dans launchSettings.json.

  • --kestrelHttpsPort

    Numéro de port à utiliser pour le point de terminaison HTTPS dans launchSettings.json. Cette option n’est pas applicable lorsque le paramètre no-https est utilisé (mais no-https est ignoré lorsqu’un paramètre d’authentification individuelle ou organisationnelle est choisi pour --auth).

  • --use-program-main

    Si spécifié, une Programclasse et Main une méthode explicites sont utilisées au lieu d’instructions de niveau supérieur. Disponible depuis le SDK .NET 6.0.300. Valeur par défaut : false.

web

  • --exclude-launch-settings

    Exclut launchSettings.json du modèle généré.

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler. Option non disponible dans le Kit de développement logiciel (SDK) .NET Core 2.2.

    Le tableau suivant répertorie les valeurs par défaut en fonction du numéro de version du Kit de développement logiciel (SDK) que vous utilisez :

    Version du SDK Valeur par défaut
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.1

    Pour créer un projet qui cible une infrastructure antérieure au Kit de développement logiciel (SDK) que vous utilisez, consultez --frameworkconsole les projets présentée plus haut dans cet article.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

  • --no-https

    Désactive HTTPS.

  • --kestrelHttpPort

    Numéro de port à utiliser pour le point de terminaison HTTP dans launchSettings.json.

  • --kestrelHttpsPort

    Numéro de port à utiliser pour le point de terminaison HTTPS dans launchSettings.json. Cette option n’est pas applicable lorsque le paramètre no-https est utilisé (mais no-https est ignoré lorsqu’un paramètre d’authentification individuelle ou organisationnelle est choisi pour --auth).

  • --use-program-main

    Si spécifié, une Programclasse et Main une méthode explicites sont utilisées au lieu d’instructions de niveau supérieur. Disponible depuis le SDK .NET 6.0.300. Valeur par défaut : false.

mvc, webapp

  • -au|--auth <AUTHENTICATION_TYPE>

    Type d’authentification à utiliser. Les valeurs possibles sont les suivantes :

    • None : aucune authentification (configuration par défaut).
    • Individual : authentification individuelle.
    • IndividualB2C : authentification individuelle avec Azure AD B2C.
    • SingleOrg : authentification d’organisation pour un seul abonné. Les locataires ID externe Microsoft Entra utilisent également SingleOrg.
    • MultiOrg : authentification d’organisation pour plusieurs abonnés.
    • Windows : authentification Windows.

  • --aad-b2c-instance <INSTANCE>

    L’instance d’Azure Active Directory B2C à laquelle se connecter. À utiliser avec l’authentification IndividualB2C. La valeur par défaut est https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    L’ID de la stratégie de connexion et d’inscription pour ce projet. À utiliser avec l’authentification IndividualB2C.

  • -rp|--reset-password-policy-id <ID>

    L’ID de stratégie de réinitialisation du mot de passe pour ce projet. À utiliser avec l’authentification IndividualB2C.

  • -ep|--edit-profile-policy-id <ID>

    L’ID de stratégie de modification du profil pour ce projet. À utiliser avec l’authentification IndividualB2C.

  • --aad-instance <INSTANCE>

    L’instance d’Azure Active Directory à laquelle se connecter. À utiliser avec l’authentification SingleOrg ou MultiOrg. La valeur par défaut est https://login.microsoftonline.com/.

  • --client-id <ID>

    L’ID client pour ce projet. À utiliser avec l’authentification IndividualB2C, SingleOrg ou MultiOrg. La valeur par défaut est 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Le domaine pour l’abonné d’annuaire. À utiliser avec l’authentification SingleOrg ou IndividualB2C. La valeur par défaut est qualified.domain.name.

  • --tenant-id <ID>

    L’ID d’abonné de l’annuaire auquel se connecter. À utiliser avec l’authentification SingleOrg. La valeur par défaut est 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Le chemin d’accès de la demande dans le chemin d’accès de base de l’application de l’URI de redirection. À utiliser avec l’authentification SingleOrg ou IndividualB2C. La valeur par défaut est /signin-oidc.

  • -r|--org-read-access

    Permet à cette application d’accéder en lecture au répertoire. S’applique uniquement à l’authentification SingleOrg ou MultiOrg.

  • --exclude-launch-settings

    Exclut launchSettings.json du modèle généré.

  • --no-https

    Désactive HTTPS. Cette option s’applique uniquement si Individual, IndividualB2C, SingleOrg ou MultiOrg ne sont pas utilisés.

  • -uld|--use-local-db

    Spécifie que LocalDB doit être utilisé à la place de SQLite. S’applique uniquement à l’authentification Individual ou IndividualB2C.

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler. Option disponible depuis le SDK .NET Core 3.0.

    Le tableau suivant répertorie les valeurs par défaut en fonction du numéro de version du Kit de développement logiciel (SDK) que vous utilisez :

    Version du SDK Valeur par défaut
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0

    Pour créer un projet qui cible une infrastructure antérieure au Kit de développement logiciel (SDK) que vous utilisez, consultez --frameworkconsole les projets présentée plus haut dans cet article.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

  • --use-browserlink

    Inclut BrowserLink dans le projet. Option non disponible dans le Kit de développement logiciel (SDK) .NET Core 2.2 et 3.1.

  • -rrc|--razor-runtime-compilation

    Détermine si le projet est configuré pour utiliser la compilation d’exécution Razor dans les versions Debug. Option disponible depuis le kit SDK .NET Core 3.1.201.

  • --kestrelHttpPort

    Numéro de port à utiliser pour le point de terminaison HTTP dans launchSettings.json.

  • --kestrelHttpsPort

    Numéro de port à utiliser pour le point de terminaison HTTPS dans launchSettings.json. Cette option n’est pas applicable lorsque le paramètre no-https est utilisé (mais no-https est ignoré lorsqu’un paramètre d’authentification individuelle ou organisationnelle est choisi pour --auth).

  • --use-program-main

    Si spécifié, une Programclasse et Main une méthode explicites sont utilisées au lieu d’instructions de niveau supérieur. Disponible depuis le SDK .NET 6.0.300. Valeur par défaut : false.

angular, react

Supprimé depuis le Kit de développement logiciel (SDK) .NET 8.

  • -au|--auth <AUTHENTICATION_TYPE>

    Type d’authentification à utiliser. Option disponible à partir du kit SDK .NET Core 3.0.

    Les valeurs possibles sont les suivantes :

    • None : aucune authentification (configuration par défaut).
    • Individual : authentification individuelle.

  • --exclude-launch-settings

    Exclut launchSettings.json du modèle généré.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

  • --no-https

    Désactive HTTPS. Cette option s’applique uniquement si l’authentification est None.

  • -uld|--use-local-db

    Spécifie que LocalDB doit être utilisé à la place de SQLite. S’applique uniquement à l’authentification Individual ou IndividualB2C. Option disponible à partir du kit SDK .NET Core 3.0.

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler. Option non disponible dans le Kit de développement logiciel (SDK) .NET Core 2.2.

    Le tableau suivant répertorie les valeurs par défaut en fonction du numéro de version du Kit de développement logiciel (SDK) que vous utilisez :

    Remarque

    Il n’existe pas de modèle React pour net8.0. Toutefois, si vous souhaitez développer des applications React avec ASP.NET Core, consultez Vue d’ensemble des applications monopage (SPA, Single Page Apps) dans ASP.NET Core.

    Version du SDK Valeur par défaut
    7.0 net7.0
    6.0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.0

    Pour créer un projet qui cible une infrastructure antérieure au Kit de développement logiciel (SDK) que vous utilisez, consultez --frameworkconsole les projets présentée plus haut dans cet article.

  • --kestrelHttpPort

    Numéro de port à utiliser pour le point de terminaison HTTP dans launchSettings.json.

  • --kestrelHttpsPort

    Numéro de port à utiliser pour le point de terminaison HTTPS dans launchSettings.json. Cette option n’est pas applicable lorsque le paramètre no-https est utilisé (mais no-https est ignoré lorsqu’un paramètre d’authentification individuelle ou organisationnelle est choisi pour --auth).

  • --use-program-main

    Si spécifié, une Programclasse et Main une méthode explicites sont utilisées au lieu d’instructions de niveau supérieur. Disponible depuis le SDK .NET 6.0.300. Valeur par défaut : false.

razorclasslib

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

  • -s|--support-pages-and-views

    Prend en charge l’ajout de pages Razor traditionnelles et de Vues en plus des composants de cette bibliothèque. Option disponible à partir du kit SDK .NET Core 3.0.

webapiaot

Crée un projet d’API web avec la publication AOA activée. Pour plus d’informations, consultez Déploiement AOA natif et Modèle d’API web (AOA natif).

  • --exclude-launch-settings

    Exclut launchSettings.json du modèle généré.

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler.

    Le tableau suivant répertorie les valeurs par défaut en fonction du numéro de version du Kit de développement logiciel (SDK) que vous utilisez :

    Version du SDK Valeur par défaut
    8.0 net8.0

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

  • --use-program-main

    Si spécifié, une Programclasse et Main une méthode explicites sont utilisées au lieu d’instructions de niveau supérieur. Disponible depuis le SDK .NET 6.0.300. Valeur par défaut : false.

webapi

  • -au|--auth <AUTHENTICATION_TYPE>

    Type d’authentification à utiliser. Les valeurs possibles sont les suivantes :

    • None : aucune authentification (configuration par défaut).
    • IndividualB2C : authentification individuelle avec Azure AD B2C.
    • SingleOrg : authentification d’organisation pour un seul abonné. Les locataires ID externe Microsoft Entra utilisent également SingleOrg.
    • Windows : authentification Windows.

  • --aad-b2c-instance <INSTANCE>

    L’instance d’Azure Active Directory B2C à laquelle se connecter. À utiliser avec l’authentification IndividualB2C. La valeur par défaut est https://login.microsoftonline.com/tfp/.

  • -minimal|--use-minimal-apis

    Créez un projet qui utilise l’API minimale ASP.NET Core. La valeur par défaut est false, mais cette option est remplacée par -controllers. Étant donné que la valeur par défaut -controllers est false, renseigner dotnet new webapi, sans spécifier l’une ou l’autre option, crée un projet d’API minimal.

  • -ssp|--susi-policy-id <ID>

    L’ID de la stratégie de connexion et d’inscription pour ce projet. À utiliser avec l’authentification IndividualB2C.

  • --aad-instance <INSTANCE>

    L’instance d’Azure Active Directory à laquelle se connecter. À utiliser avec l’authentification SingleOrg. La valeur par défaut est https://login.microsoftonline.com/.

  • --client-id <ID>

    L’ID client pour ce projet. À utiliser avec l’authentification IndividualB2C ou SingleOrg. La valeur par défaut est 11111111-1111-1111-11111111111111111.

  • -controllers|--use-controllers

    Indique s’il faut utiliser des contrôleurs plutôt que des API minimales. Si cette option et -minimal sont spécifiées, cette option remplace la valeur spécifiée par -minimal. La valeur par défaut est false. Disponible depuis le Kit de développement logiciel (SDK) .NET 8.

  • --domain <DOMAIN>

    Le domaine pour l’abonné d’annuaire. À utiliser avec l’authentification IndividualB2C ou SingleOrg. La valeur par défaut est qualified.domain.name.

  • --tenant-id <ID>

    L’ID d’abonné de l’annuaire auquel se connecter. À utiliser avec l’authentification SingleOrg. La valeur par défaut est 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Permet à cette application d’accéder en lecture au répertoire. S’applique uniquement à l’authentification SingleOrg.

  • --exclude-launch-settings

    Exclut launchSettings.json du modèle généré.

  • --no-openapi

    Désactive la prise en charge d’OpenAPI (Swagger). AddSwaggerGen, UseSwagger et UseSwaggerUI ne sont pas appelés.

  • --no-https

    Désactive HTTPS. Aucun profil de lancement https n’est créé dans launchSettings.json. app.UseHsts et app.UseHttpsRedirection ne sont pas appelés dans Program.cs/Startup.cs. Cette option s’applique uniquement si IndividualB2C ou SingleOrg ne sont pas utilisés pour l’authentification.

  • -uld|--use-local-db

    Spécifie que LocalDB doit être utilisé à la place de SQLite. S’applique uniquement à l’authentification IndividualB2C.

  • -f|--framework <FRAMEWORK>

    Spécifie le cadre à cibler. Option non disponible dans le Kit de développement logiciel (SDK) .NET Core 2.2.

    Le tableau suivant répertorie les valeurs par défaut en fonction du numéro de version du Kit de développement logiciel (SDK) que vous utilisez :

    Version du SDK Valeur par défaut
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.1

    Pour créer un projet qui cible une infrastructure antérieure au Kit de développement logiciel (SDK) que vous utilisez, consultez --frameworkconsole les projets présentée plus haut dans cet article.

  • --no-restore

    N’exécute aucune restauration implicite pendant la création du projet.

  • --use-program-main

    Si spécifié, une Programclasse et Main une méthode explicites sont utilisées au lieu d’instructions de niveau supérieur. Disponible depuis le SDK .NET 6.0.300. Valeur par défaut : false.

apicontroller

Contrôleur d’API avec ou sans actions en lecture/écriture.

  • -p:n|--name <NAME>

    Espace de noms du code généré. La valeur par défaut est MyApp.Namespace.

  • -ac|--actions

    Créez un contrôleur avec des actions en lecture/écriture. La valeur par défaut est false.

globaljson

  • --sdk-version <VERSION_NUMBER>

    Spécifie la version du SDK .NET à utiliser dans le fichier global.json.

  • --roll-forward <ROLL_FORWARD_POLICY>

    Stratégie de restauration par progression à utiliser lors de la sélection d’une version du kit de développement logiciel (SDK), soit comme secours lorsqu’une version spécifique du kit de développement logiciel (SDK) est manquante, soit en tant que directive pour utiliser une version ultérieure. Pour plus d’informations, consultez global-json.

editorconfig

Crée un fichier .editorconfig pour la configuration des préférences de style de code.

  • --empty

    Crée un .editorconfig vide au lieu des valeurs par défaut pour .NET.

Voir aussi