Compartilhar via

nova lista dotnet

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

Nome

dotnet new list - Lista os modelos disponíveis a 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 a serem usados com dotnet new. Se o <TEMPLATE_NAME> for especificado, lista os modelos que contêm o nome especificado. Essa opção lista apenas modelos padrão e instalados. Para localizar modelos no NuGet que você pode instalar localmente, use o search comando.

A partir do SDK do .NET 7.0.100, o list comando pode não mostrar todos os modelos instalados no computador. 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 opção --ignore-constraints .

Observação

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

  • As opções --list, --search, --installe --uninstall tornaram-se subcomandos list, search, installe uninstall.
  • 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 respectivos subcomandos. A ajuda separada para cada subcomando está disponível por meio da opção -h ou --help: dotnet new <subcommand> --help lista todas as opções com suporte para o subcomando.

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

Exemplos da sintaxe antiga:

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

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

Arguments

  • TEMPLATE_NAME

    Se o argumento for especificado, somente os modelos que contêm <TEMPLATE_NAME> o nome do modelo ou o nome curto serão mostrados.

Opções

  • --author <AUTHOR>

    Filtra modelos com base no autor do modelo. Há suporte para correspondência parcial. Disponível desde o SDK do .NET 5.0.300.

  • --columns <COLUMNS>

    Lista separada por vírgulas de colunas a serem exibidas na saída. As colunas com suporte são:

    • language - Uma lista separada por vírgulas de idiomas compatíveis com o modelo.
    • tags - A lista de marcas de modelo.
    • author - O autor do modelo.
    • type - O tipo de modelo: projeto ou item.

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

  • --columns-all

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

  • -d|--diagnostics

    Habilita a saída de diagnóstico. Disponível desde o SDK do .NET 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 o SDK do .NET 7.0.100.

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

    Filtra modelos com base no idioma compatível com o modelo. O idioma aceito varia de acordo com o modelo. Não é válida para alguns modelos.

    Observação

    Alguns shells interpretam # como um caractere especial. Nesses casos, coloque o valor do parâmetro de idioma 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 de lista, talvez seja necessário especificar o diretório de saída para avaliar corretamente as restrições do modelo. Disponível desde o SDK do .NET 7.0.100.

  • --project <PROJECT_PATH>

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

  • --tag <TAG>

    Filtra modelos com base em marcas de modelo. Para ser selecionado, um modelo deve ter pelo menos uma marca que corresponda exatamente aos critérios. Disponível desde o SDK do .NET 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 detalhes 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.

Exemplos

  • Listar todos os modelos

    dotnet new list

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

    dotnet new list spa

  • Liste todos os modelos correspondentes à subcadeia de caracteres de nós .

    dotnet new list we

  • Liste todos os modelos que correspondem à subcadeia de caracteres que dão suporte à linguagem F#.

    dotnet new list we --language "F#"

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