dotnet new search

  • Article

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

Nom

dotnet new search : recherche les modèles pris en charge par dotnet new sur NuGet.org.

Synopsis

dotnet new search <TEMPLATE_NAME>

dotnet new search [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language {"C#"|"F#"|VB}]
    [--package <PACKAGE>] [--tag <TAG>] [--type <TYPE>]
    [--columns <COLUMNS>] [--columns-all]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Description

La commande dotnet new search recherche les modèles pris en charge par dotnet new sur NuGet.org. Quand <TEMPLATE_NAME> est spécifié, recherche les modèles contenant le nom spécifié.

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 :

  • Recherche de tous les modèles disponibles sur NuGet.org correspondant à la sous-chaîne « we » et prenant en charge le langage F#

    dotnet new we --search --language "F#"

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. L’argument est obligatoire quand les options --author, --language, --package, --tag ou --type ne sont pas spécifiées.

    Notes

    À compter du kit SDK .NET 6.0.100, vous pouvez placer l’argument <TEMPLATE_NAME> après l’option --search. Par exemple, dotnet new --search web fournit le même résultat que dotnet new web --search. L’utilisation de plusieurs arguments n’est pas autorisée.

Options

  • --author <AUTHOR>

    Filtre les modèles en fonction de l’auteur du modèle. La correspondance partielle est prise en charge.

  • --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 : type de modèle : projet ou élément.

    Le nom du modèle, le nom court, le nom du package et le nombre total de téléchargements sont toujours affichés. La liste par défaut des colonnes est le nom du modèle, le nom court, l’auteur, le langage, le package et le nombre total de téléchargements. La liste équivaut à spécifier --columns=author,language.

  • --columns-all

    Affiche toutes les colonnes dans la sortie.

  • -d|--diagnostics

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

  • -h|--help

    Affiche l’aide pour la commande de recherche. Disponible depuis le kit 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 --search --language "F#".

  • --package <PACKAGE>

    Filtre les modèles en fonction de l’ID de package NuGet. La correspondance partielle est prise en charge.

  • --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.

  • --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 kit SDK .NET 7.0.100.

Notes

Pour vous assurer que le package de modèle apparaît dans le résultat dotnet new --search, définissez le type de package NuGet sur Template.

Exemples

  • Recherchez tous les modèles disponibles sur NuGet.org correspondant à la sous-chaîne spa.

    dotnet new search spa

  • Recherchez tous les modèles disponibles sur NuGet.org correspondant à la sous-chaîne we et prenant en charge le langage F#.

    dotnet new search we --language "F#"

  • Recherchez des modèles d’élément.

    dotnet new search --type item

  • Recherchez tous les modèles C#, montrant le type et les balises dans la sortie.

    dotnet new search --language "C#" --columns "type,tags"

Voir aussi