dotnet new list

  • Articolo

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

Nome

dotnet new list: elenca i modelli disponibili per l'esecuzione usando dotnet new.

Riepilogo

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]

Descrizione

Il comando dotnet new list elenca i modelli disponibili da usare con dotnet new. Se viene specificato il nome <TEMPLATE_NAME>, elenca i modelli contenenti il nome specificato. Questa opzione elenca solo i modelli predefiniti e installati. Per trovare in NuGet i modelli che è possibile installare in locale, usare il comando search.

A partire da .NET SDK 7.0.100, il comando list potrebbe non visualizzare tutti i modelli installati nel computer. Tiene conto del risultato dei vincoli dei modelli e i modelli che non possono essere usati non verranno visualizzati. Per forzare la visualizzazione di tutti i modelli, usare l'opzione --ignore-constraints.

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 tramite tasto TAB è 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 tramite tasto TAB per .NET SDK, vedere Abilitare il completamento tramite tasto TAB.

Esempi di sintassi precedente:

  • Elencare tutti i modelli applicazione a pagina singola:

    • a partire da .NET SDK 6.0.100
    dotnet new --list spa
    • prima di .NET SDK 6.0.100
    dotnet new spa --list

Argomenti

  • TEMPLATE_NAME

    Se l'argomento viene specificato, verranno visualizzati solo i modelli contenenti <TEMPLATE_NAME> nel nome del modello o nel nome breve.

Opzioni

  • --author <AUTHOR>

    Filtra i modelli in base all'autore del modello. La corrispondenza parziale è supportata. Disponibile a partire da .NET SDK 5.0.300.

  • --columns <COLUMNS>

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

    • language: elenco delimitato da virgole di linguaggi supportati dal modello.
    • tags: elenco dei tag del modello.
    • author: autore del modello.
    • type: tipo del modello: progetto o elemento.

    Vengono sempre visualizzati il nome del modello e il nome breve. L'elenco predefinito delle colonne è costituito da nome del modello, nome breve, linguaggio e tag. Questo elenco equivale a specificare --columns=language,tags. Disponibile a partire da .NET SDK 5.0.300.

  • --columns-all

    Visualizza tutte le colonne nell'output. Disponibile a partire da .NET SDK 5.0.300.

  • -d|--diagnostics

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

  • -h|--help

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

  • --ignore-constraints

    Disabilita il controllo per verificare se il modello soddisfa i vincoli per l'esecuzione. Disponibile a partire da .NET SDK 7.0.100.

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

    Filtra i modelli in base al linguaggio supportato dal modello. Il linguaggio accettato varia in base al modello. 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 --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    Percorso in cui posizionare l'output generato. Il valore predefinito è la directory corrente. Per il comando list, potrebbe essere necessario specificare la directory di output per valutare correttamente i vincoli per il modello. Disponibile a partire da .NET SDK 7.0.100.

  • --project <PROJECT_PATH>

    Progetto a cui viene aggiunto il modello. Per il comando list, potrebbe essere necessario specificare il progetto a cui viene aggiunto il modello per valutare correttamente i vincoli per il modello. Disponibile a partire da .NET SDK 7.0.100.

  • --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. Disponibile a partire da .NET SDK 5.0.300.

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

Esempi

  • Elenca tutti i modelli

    dotnet new list

  • Elenca tutti i modelli applicazione a pagina singola:

    dotnet new list spa

  • Elencare tutti i modelli corrispondenti alla sottostringa we.

    dotnet new list we

  • Elenca tutti i modelli corrispondenti alla sottostringa we che supporta il linguaggio F#.

    dotnet new list we --language "F#"

  • Elenca tutti i modelli di elementi.

    dotnet new list --type item

  • Elenca tutti i modelli C#, mostrando l'autore e il tipo nell'output.

    dotnet new list --language "C#" --columns "author,type"

Vedi anche