Condividi tramite

Nel contesto della linea di comando, utilizzare `dotnet new list` per elencare i modelli disponibili.

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

Nome

dotnet new list - Elenca i modelli disponibili da eseguire usando dotnet new.

Synopsis

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]

Description

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

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

Annotazioni

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 della sintassi precedente:

  • Elencare tutti i modelli applicazione a pagina singola:List all single page application (SPA) templates:

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

Arguments

  • TEMPLATE_NAME

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

Options

  • --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 lingue supportate dal modello.
    • tags - Elenco di tag di modello.
    • author - Autore del modello.
    • type - Tipo di modello: progetto o elemento.

    Vengono sempre visualizzati il nome del modello e il nome breve. L'elenco predefinito delle colonne è il nome del modello, il nome breve, la lingua e i 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 una descrizione di come usare il comando .

  • --ignore-constraints

    Disabilita il controllo se il modello soddisfa i vincoli da eseguire. Disponibile a partire da .NET SDK 7.0.100.

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

    Filtra i modelli in base alla lingua supportata dal modello. La lingua accettata varia in base al modello. Non è valido per alcuni modelli.

    Annotazioni

    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 di modello. I valori predefiniti sono project, iteme solution.

  • -v|--verbosity <LEVEL>

    Imposta il livello di dettaglio del comando. I valori consentiti sono q[uiet], m[inimal], n[ormal], d[etailed] e diag[nostic]. Per altre informazioni, vedere LoggerVerbosity.

Esempi

  • Elencare tutti i modelli

    dotnet new list

  • Elencare tutti i modelli applicazione a pagina singola:List all single page application (SPA) templates:

    dotnet new list spa

  • Elencare tutti i modelli corrispondenti alla sottostringa.

    dotnet new list we

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

    dotnet new list we --language "F#"

  • Elencare tutti i modelli di elemento.

    dotnet new list --type item

  • Elencare tutti i modelli C#, che mostrano l'autore e il tipo nell'output.

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

Vedere anche

  • Last updated on