Partilhar via

dotnet nova lista

Este artigo aplica-se a: ✔️ .NET 6 SDK e versões posteriores

Nome

dotnet new list - Lista modelos disponíveis para serem executados usando dotnet new.

Sinopse

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

O dotnet new list comando lista os modelos disponíveis para usar com dotnet newo . Se o <TEMPLATE_NAME> for especificado, lista os modelos que contêm o nome especificado. Esta opção lista apenas os modelos padrão e instalados. Para encontrar modelos no NuGet que você pode instalar localmente, use o search comando.

A partir do .NET SDK 7.0.100, o list comando pode não mostrar todos os modelos instalados na máquina. Ele leva em conta o resultado das restrições de modelo e os modelos que não podem ser usados não serão mostrados. Para forçar a exibição de todos os modelos, use a --ignore-constraints opção.

Observação

A partir do SDK do .NET 7, a sintaxe dotnet new foi alterada:

  • As opções --list, --search, --installe --uninstall tornaram-se list, search, installe uninstall subcomandos.
  • A opção --update-apply tornou-se o subcomando update.
  • Para usar --update-check, use o subcomando update com a opção --check-only.

Outras opções que estavam disponíveis antes ainda estão disponíveis para uso com seus respetivos subcomandos. Ajuda separada para cada subcomando está disponível através da opção -h ou --help: dotnet new <subcommand> --help lista todas as opções suportadas para o subcomando.

Além disso, o preenchimento de guias agora está disponível para dotnet new. Ele suporta a conclusão para nomes de modelo instalados e para as opções que um modelo selecionado fornece. Para ativar o preenchimento de guias para o SDK do .NET, consulte Habilitar conclusão de guia.

Exemplos da sintaxe antiga:

  • Liste todos os modelos de Aplicativo de Página Única (SPA):

    • desde o .NET SDK 6.0.100
    dotnet new --list spa
    • antes do .NET SDK 6.0.100
    dotnet new spa --list

Arguments

  • TEMPLATE_NAME

    Se o argumento for especificado, somente os modelos contendo <TEMPLATE_NAME> o nome do modelo ou nome abreviado serão mostrados.

Opções

  • --author <AUTHOR>

    Filtra modelos com base no autor do modelo. A correspondência parcial é suportada. Disponível desde .NET SDK 5.0.300.

  • --columns <COLUMNS>

    Lista de colunas separadas por vírgulas para exibir na saída. As colunas suportadas são:

    • language - Uma lista separada por vírgulas dos idiomas suportados pelo modelo.
    • tags - A lista de tags de modelo.
    • author - O autor do modelo.
    • type - O tipo de modelo: projeto ou item.

    O nome do modelo e o nome abreviado são sempre mostrados. A lista padrão de colunas é nome do modelo, nome curto, idioma e tags. Esta lista equivale a especificar --columns=language,tags. Disponível desde .NET SDK 5.0.300.

  • --columns-all

    Exibe todas as colunas na saída. Disponível desde .NET SDK 5.0.300.

  • -d|--diagnostics

    Permite a saída de diagnóstico. Disponível desde .NET SDK 7.0.100.

  • -?|-h|--help

    Imprime uma descrição de como usar o comando.

  • --ignore-constraints

    Desabilita a verificação se o modelo atende às restrições a serem executadas. Disponível desde .NET SDK 7.0.100.

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

    Filtra modelos com base no idioma suportado pelo modelo. O idioma aceito varia de acordo com o modelo. Não é válido para alguns modelos.

    Observação

    Algumas conchas interpretam # como um caráter especial. Nesses casos, coloque o valor do parâmetro language entre aspas. Por exemplo, dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    Local para colocar a saída gerada. O padrão é o diretório atual. Para o comando list, pode ser necessário especificar o diretório de saída para avaliar corretamente as restrições para o modelo. Disponível desde .NET SDK 7.0.100.

  • --project <PROJECT_PATH>

    O projeto ao qual o modelo é adicionado. Para o comando list, pode ser necessário especificar o projeto ao qual o modelo está sendo adicionado para avaliar corretamente as restrições para o modelo. Disponível desde .NET SDK 7.0.100.

  • --tag <TAG>

    Filtra modelos com base em tags de modelo. Para ser selecionado, um modelo deve ter pelo menos uma tag que corresponda exatamente aos critérios. Disponível desde .NET SDK 5.0.300.

  • --type <TYPE>

    Filtra modelos com base no tipo de modelo. Os valores predefinidos são project, iteme solution.

  • -v|--verbosity <LEVEL>

    Define o nível de verbosidade do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal], d[etailed], e diag[nostic]. Para obter mais informações, consulte LoggerVerbosity.

Examples

  • Listar todos os modelos

    dotnet new list

  • Liste todos os modelos de Aplicativo de Página Única (SPA):

    dotnet new list spa

  • Liste todos os modelos correspondentes à substring we .

    dotnet new list we

  • Liste todos os modelos correspondentes à substring we que suportam a linguagem F#.

    dotnet new list we --language "F#"

  • Liste todos os modelos de item.

    dotnet new list --type item

  • Liste todos os modelos C#, mostrando o autor e o tipo na saída.

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

Consulte também

  • Last updated on