Partager via

dotnet new list - Affiche une liste de modèles disponibles

Cet article s’applique à : ✔️ SDK .NET Core 6 et versions ultérieures

Nom

dotnet new list - Répertorie les modèles disponibles à exécuter à l’aide dotnet newde .

Synopsis

dotnet new list [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language {"C#"|"F#"|VB}]
    [--tag <TAG>] [--type <TYPE>] [--columns <COLUMNS>] [--columns-all]
    [-o|--output <output>] [--project <project>] [--ignore-constraints]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Descriptif

La dotnet new list commande répertorie les modèles disponibles à utiliser avec dotnet new. Si le <TEMPLATE_NAME> est spécifié, répertorie les modèles contenant le nom spécifié. Cette option répertorie uniquement les modèles par défaut et installés. Pour rechercher des modèles dans NuGet que vous pouvez installer localement, utilisez la search commande.

À compter du SDK .NET 7.0.100, la list commande risque de ne pas afficher tous les modèles installés sur l’ordinateur. Le résultat des contraintes de modèle est pris en compte et les modèles qui ne peuvent pas être utilisés ne sont pas affichés. Pour forcer l’affichage de tous les modèles, utilisez l’option --ignore-constraints .

Note

À compter du Kit de développement logiciel (SDK) .NET 7, la syntaxe dotnet new a changé :

  • Les options --list, --search, --installet --uninstall deviennent list, search, installet sous-commandes uninstall.
  • L’option --update-apply est devenue la sous-commande update.
  • Pour utiliser --update-check, utilisez la sous-commande update avec l’option --check-only.

D’autres options disponibles avant sont toujours disponibles pour être utilisées avec leurs sous-commandes respectives. Une aide distincte pour chaque sous-commande est disponible via l’option -h ou --help : dotnet new <subcommand> --help répertorie toutes les options prises en charge pour la sous-commande.

En outre, la saisie semi-automatique de tabulation est désormais disponible pour dotnet new. Il prend en charge la saisie semi-automatique pour les noms de modèles installés et pour les options qu’un modèle sélectionné fournit. Pour activer la saisie semi-automatique des onglets pour le Kit de développement logiciel (SDK) .NET, consultez Activer la saisie semi-automatique des onglets.

Exemples de l’ancienne syntaxe :

  • Répertorier tous les modèles d’application monopage (SPA) :

    • depuis .NET SDK 6.0.100
    dotnet new --list spa
    • avant .NET SDK 6.0.100
    dotnet new spa --list

Arguments

  • TEMPLATE_NAME

    Si l’argument est spécifié, seuls les modèles contenant <TEMPLATE_NAME> le nom du modèle ou le nom court s’affichent.

Options

  • --author <AUTHOR>

    Filtre les modèles basés sur l’auteur du modèle. La correspondance partielle est prise en charge. Disponible depuis .NET SDK 5.0.300.

  • --columns <COLUMNS>

    Liste séparée par des virgules de colonnes à afficher dans la sortie. Les colonnes prises en charge sont les suivantes :

    • language - Liste séparée par des virgules des langues prises en charge par le modèle.
    • tags - Liste des balises de modèle.
    • author - Auteur du modèle.
    • type - Type de modèle : projet ou élément.

    Le nom du modèle et le nom court sont toujours affichés. La liste par défaut des colonnes est le nom du modèle, le nom court, la langue et les balises. Cette liste équivaut à spécifier --columns=language,tags. Disponible depuis .NET SDK 5.0.300.

  • --columns-all

    Affiche toutes les colonnes de la sortie. Disponible depuis .NET SDK 5.0.300.

  • -d|--diagnostics

    Active la sortie de diagnostic. Disponible depuis .NET SDK 7.0.100.

  • -?|-h|--help

    Imprime une description de l’utilisation de la commande.

  • --ignore-constraints

    Désactive la vérification si le modèle répond aux contraintes à exécuter. Disponible depuis .NET SDK 7.0.100.

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

    Filtre les modèles en fonction du langage pris en charge par le modèle. La langue acceptée varie selon le modèle. Non valide pour certains modèles.

    Note

    Certains interpréteurs interprètent la commande # comme un caractère spécial. Dans ces cas, placez la valeur du paramètre de langage entre guillemets. Par exemple : dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    Emplacement où placer la sortie générée. L'emplacement par défaut est le répertoire actif. Pour la commande de liste, il peut être nécessaire de spécifier le répertoire de sortie pour évaluer correctement les contraintes du modèle. Disponible depuis .NET SDK 7.0.100.

  • --project <PROJECT_PATH>

    Projet auquel le modèle est ajouté. Pour la commande de liste, il peut être nécessaire de spécifier le projet que le modèle est ajouté pour évaluer correctement les contraintes du modèle. Disponible depuis .NET SDK 7.0.100.

  • --tag <TAG>

    Filtre les modèles en fonction des balises de modèle. Pour être sélectionné, un modèle doit avoir au moins une balise qui correspond exactement aux critères. Disponible depuis .NET SDK 5.0.300.

  • --type <TYPE>

    Filtre les modèles en fonction du type de modèle. Les valeurs prédéfinies sont project, itemet solution.

  • -v|--verbosity <LEVEL>

    Définit le niveau de détail de la commande. Les valeurs autorisées sont q[uiet], m[inimal], n[ormal], d[etailed] et diag[nostic]. Pour plus d’informations, consultez LoggerVerbosity.

Examples

  • Répertorier tous les modèles

    dotnet new list

  • Répertorier tous les modèles d’application monopage (SPA) :

    dotnet new list spa

  • Répertorier tous les modèles correspondant à la sous-chaîne que nous avons.

    dotnet new list we

  • Répertorier tous les modèles correspondant à la sous-chaîne que nous prenons en charge le langage F#.

    dotnet new list we --language "F#"

  • Répertorier tous les modèles d’élément.

    dotnet new list --type item

  • Répertoriez tous les modèles C#, montrant l’auteur et le type dans la sortie.

    dotnet new list --language "C#" --columns "author,type"

Voir aussi

  • Last updated on