dotnet new search

Questo articolo si applica a: ✔️ .NET Core 5.0.300 SDK e versioni successive

Nome

dotnet new search: cerca i modelli supportati da dotnet new in NuGet.org.

Riepilogo

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]

Descrizione

Il comando dotnet new search cerca i modelli supportati da dotnet new in NuGet.org. Quando viene specificato il <TEMPLATE_NAME>, cerca i modelli contenenti il nome specificato.

Nota

A partire da .NET 7 SDK, la sintassi dotnet new è cambiata:

  • Le opzioni --list, --search, --install e --uninstall sono diventate i sottocomandi list, search, install e uninstall.
  • L'opzione --update-apply è diventata il sottocomando update.
  • Per usare --update-check, usare il sottocomando update con l'opzione --check-only.

Altre opzioni disponibili prima sono ancora disponibili per l'uso con i rispettivi sottocomandi. La Guida separata per ogni sottocomando è disponibile tramite l'opzione -h o --help: dotnet new <subcommand> --help elenca tutte le opzioni supportate per il sottocomando.

Inoltre, il completamento della scheda è ora disponibile per dotnet new. Supporta il completamento per i nomi dei modelli installati e per le opzioni fornite da un modello selezionato. Per attivare il completamento della scheda per .NET SDK, vedere Abilitare il completamento della scheda.

Esempi di sintassi precedente:

  • Cercare tutti i modelli disponibili in NuGet.org corrispondenti alla sottostringa "we" e che supportano il linguaggio F#

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

Argomenti

  • TEMPLATE_NAME

    Se l'argomento viene specificato, verranno visualizzati solo i modelli contenenti <TEMPLATE_NAME> nel nome del modello o nome breve. L'argomento è obbligatorio quando --authornon vengono specificate le opzioni , --language--package, --tag, o --type .

    Nota

    A partire da .NET SDK 6.0.100, è possibile inserire l'argomento <TEMPLATE_NAME> dopo l'opzione --search. Ad esempio, dotnet new --search web fornisce lo stesso risultato di dotnet new web --search. L'uso di più argomenti non è consentito.

Opzioni

  • --author <AUTHOR>

    Filtra i modelli in base all'autore del modello. È supportata una corrispondenza parziale.

  • --columns <COLUMNS>

    Elenco di colonne da visualizzare nell'output. Le colonne supportate sono:

    • author: autore del modello.
    • language - Lingua del modello.
    • tags: elenco dei tag del modello.
    • type - Tipo di modello.

    Vengono sempre visualizzati il nome del modello, il nome breve, il nome del pacchetto, un'indicazione se si tratta di un'origine attendibile e il numero totale di download. L'elenco predefinito delle colonne è il nome del modello, il nome breve, la lingua, il pacchetto, un'indicazione se si tratta di un'origine attendibile e il totale dei download. Per specificare più colonne, usare l'opzione --columns più volte.

  • --columns-all

    Visualizza tutte le colonne nell'output.

  • -d|--diagnostics

    Abilita l'output di diagnostica. Disponibile a partire da .NET SDK 7.0.100.

  • -h|--help

    Stampa la Guida per il comando di ricerca. Disponibile a partire da .NET SDK 7.0.100.

  • -lang|--language <language>

    Filtra i modelli in base al linguaggio supportato dal modello. Il linguaggio accettato varia in base al modello, i linguaggi possibili sono C#, F#, VB, SQL, JSON, TypeScript e altro ancora. Non è valido per alcuni modelli.

    Nota

    Alcune shell interpretano # come un carattere speciale. In questi casi, è necessario racchiudere il valore del parametro del linguaggio tra virgolette. Ad esempio: dotnet new --search --language "F#".

  • --package <PACKAGE>

    Filtra i modelli in base all'ID pacchetto NuGet. È supportata una corrispondenza parziale.

  • --tag <TAG>

    Filtra i modelli in base ai tag del modello. Per essere selezionato, un modello deve avere almeno un tag che corrisponda esattamente ai criteri.

  • --type <TYPE>

    Filtra i modelli in base al tipo del modello. I valori predefiniti sono project, item e solution.

  • -v|--verbosity <LEVEL>

    Imposta il livello di dettaglio del comando. I valori consentiti sono q[uiet], m[inimal], n[ormal] e diag[nostic]. Disponibile a partire da .NET SDK 7.0.100.

Nota

Per assicurarsi che il pacchetto di modelli compaia nei risultati di dotnet new --search, impostare il tipo di pacchetto NuGet su Template.

Esempi

  • Cercare tutti i modelli disponibili in NuGet.org corrispondenti alla sottostringa spa.

    dotnet new search spa
    
  • Cercare tutti i modelli disponibili in NuGet.org corrispondenti alla sottostringa we e che supportano il linguaggio F#.

    dotnet new search we --language "F#"
    
  • Cercare modelli di elemento.

    dotnet new search --type item
    
  • Cercare tutti i modelli C#, che mostrano il tipo e i tag nell'output.

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

Vedi anche