Partager via


dotnet nouvelle recherche

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

Nom

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

Synopsis

dotnet new search <TEMPLATE_NAME>

dotnet new search [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language <language>]
    [--package <PACKAGE>] [--tag <TAG>] [--type <TYPE>]
    [--columns <author|language|tags|type>] [--columns-all]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Descriptif

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

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 :

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

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

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

    Note

    À compter du Kit de développement logiciel (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 basés sur l’auteur du modèle. Une correspondance partielle est prise en charge.

  • --columns <COLUMNS>

    Liste des colonnes à afficher dans la sortie. Les colonnes prises en charge sont les suivantes :

    • author - Auteur du modèle.
    • language - Langue du modèle.
    • tags - Liste des balises de modèle.
    • type - Type de modèle.

    Le nom du modèle, le nom court, le nom du package, une indication s’il s’agit d’une source approuvée et le nombre total de téléchargements est toujours affiché. La liste par défaut des colonnes est le nom du modèle, le nom court, la langue, le package, une indication s’il s’agit d’une source approuvée et des téléchargements totaux. Pour spécifier plusieurs colonnes, utilisez l’option --columns plusieurs fois.

  • --columns-all

    Affiche toutes les colonnes de la sortie.

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

  • -lang|--language <language>

    Filtre les modèles en fonction du langage pris en charge par le modèle. Le langage accepté varie selon le modèle, les langages possibles sont C#, F#, VB, SQL, JSON, TypeScript, etc. 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 --search --language "F#".

  • --package <PACKAGE>

    Filtre les modèles basés sur l’ID de package NuGet. Une correspondance partielle est prise en charge.

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

  • --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]et diag[nostic]. Disponible depuis .NET SDK 7.0.100.

Note

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.

Examples

  • 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 que nous prenons 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#, affichant le type et les balises dans la sortie.

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

Voir aussi