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 sottocomandilist
,search
,install
euninstall
. - L'opzione
--update-apply
è diventata il sottocomandoupdate
. - Per usare
--update-check
, usare il sottocomandoupdate
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--author
non 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 didotnet 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
esolution
.-v|--verbosity <LEVEL>
Imposta il livello di dettaglio del comando. I valori consentiti sono
q[uiet]
,m[inimal]
,n[ormal]
ediag[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"