dotnet new list

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

Nom

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

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]

Description

La commande dotnet new list répertorie les modèles disponibles à utiliser avec dotnet new. Si le <TEMPLATE_NAME> est spécifié, les modèles contenant le nom spécifié sont répertoriés. 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 commande search.

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

Notes

À compter du SDK .NET 7, la syntaxe dotnet new a changé :

  • Les options --list, --search, --install et --uninstall sont devenues les sous-commandes list, search, install et 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 l’option --help : dotnet new <subcommand> --help répertorie toutes les options prises en charge pour la sous-commande.

En outre, la saisie semi-automatique est désormais disponible pour dotnet new. Elle prend en charge la saisie semi-automatique pour les noms de modèles installés et pour les options fournies par le modèle sélectionné. Pour activer la saisie semi-automatique dans le SDK .NET, consultez Activer la saisie semi-automatique.

Exemples de l’ancienne syntaxe :

  • Répertoriez tous les modèles d’application à page unique (SPA) :

    • depuis SDK .NET 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> dans le nom de modèle ou un nom court s’affichent.

Options

  • --author <AUTHOR>

    Filtre les modèles en fonction de l’auteur du modèle. La correspondance partielle est prise en charge. Disponible depuis le SDK .NET 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 langages pris en charge par le modèle.
    • tags : liste des balises de modèle.
    • author : auteur du modèle.
    • type - Le 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, le langage et les balises. La liste équivaut à spécifier --columns=language,tags. Disponible depuis le SDK .NET 5.0.300.

  • --columns-all

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

  • -d|--diagnostics

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

  • -h|--help

    Affiche l’aide pour la commande de liste. Disponible depuis le SDK .NET 7.0.100.

  • --ignore-constraints

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

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

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

    Notes

    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 pour le modèle. Disponible depuis le SDK .NET 7.0.100.

  • --project <PROJECT_PATH>

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

  • --tag <TAG>

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

  • --type <TYPE>

    Filtre les modèles en fonction du type de modèle. Les valeurs prédéfinies sont project, item et 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] et diag[nostic]. Disponible depuis le SDK .NET 7.0.100.

Exemples

  • Répertoriez tous les modèles

    dotnet new list
    
  • Répertoriez tous les modèles d’application à page unique (SPA) :

    dotnet new list spa
    
  • Liste de tous les modèles correspondant à la sous-chaîne we.

    dotnet new list we
    
  • Répertoriez tous les modèles correspondant à la substring we qui prend en charge le langage F#.

    dotnet new list we --language "F#"
    
  • Répertoriez 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