nova pesquisa do dotnet

  • Artigo

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

Nome

dotnet new search - pesquisa os modelos compatíveis com dotnet new em NuGet.org.

Sinopse

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]

Descrição

O comando dotnet new search pesquisa modelos compatíveis com dotnet new em NuGet.org. Quando o <TEMPLATE_NAME> é especificado, procura modelos que contêm o nome especificado.

Observação

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

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

Além disso, o preenchimento com Tab agora está disponível para dotnet new. Ele oferece suporte ao preenchimento de nomes de modelo instalados e às opções fornecidas por um modelo selecionado. Para ativar o preenchimento com Tab no SDK do .NET, confira Habilitar o preenchimento com Tab.

Exemplos da sintaxe antiga:

  • Pesquise todos os modelos disponíveis em NuGet.org que correspondam à substring de caracteres "nós" e suporte à linguagem F#

    dotnet new we --search --language "F#"

Argumentos

  • TEMPLATE_NAME

    Se o argumento for especificado, somente os modelos que contêm <TEMPLATE_NAME> no nome do modelo ou no nome curto serão mostrados. O argumento é obrigatório quando --author, --language, --package, --tagou --type opções não são especificadas.

    Observação

    Do SDK do .NET 6.0.100 em diante, você pode colocar o argumento <TEMPLATE_NAME> após a opção --search. Por exemplo, dotnet new --search web fornece o mesmo resultado que dotnet new web --search. Não é permitido usar mais de um argumento.

Opções

  • --author <AUTHOR>

    Filtra modelos com base no autor do modelo. Há suporte para uma correspondência parcial.

  • --columns <COLUMNS>

    A lista de colunas a serem exibidas na saída. As colunas com suporte são:

    • author – O autor do modelo.
    • language - A linguagem do modelo.
    • tags – A lista de marcas de modelo.
    • type - O tipo de modelo.

    O nome do modelo, o nome curto, o nome do pacote, uma indicação se é uma fonte confiável e a contagem total de downloads são sempre mostrados. A lista padrão de colunas é nome do modelo, nome curto, idioma, pacote, uma indicação se é uma fonte confiável e total de downloads. Para especificar várias colunas, use a --columns opção várias vezes.

  • --columns-all

    Exibe todas as colunas na saída.

  • -d|--diagnostics

    Habilita a saída de diagnóstico. Disponível desde o .NET 7.0.100.

  • -h|--help

    Imprime uma ajuda para o comando de pesquisa. Disponível desde o .NET 7.0.100.

  • -lang|--language <language>

    Filtra modelos com base na linguagem compatível com o modelo. A linguagem aceita varia de acordo com o modelo, as linguagens possíveis são C#, F#, VB, SQL, JSON, TypeScript e muito mais. 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 --search --language "F#".

  • --package <PACKAGE>

    Filtra os modelos com base na ID do pacote NuGet. Há suporte para uma correspondência parcial.

  • --tag <TAG>

    Filtra modelos com base nas marcas do modelo. Para ser selecionado, um modelo precisa ter pelo menos uma marca que corresponda exatamente aos critérios.

  • --type <TYPE>

    Filtra modelos com base no tipo do modelo. Os valores predefinidos são project, item e solution.

  • -v|--verbosity <LEVEL>

    Define o nível de detalhes do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal] e diag[nostic]. Disponível desde o .NET 7.0.100.

Observação

Para garantir que o pacote de modelo seja exibido no resultado dotnet new --search, defina o tipo de pacote NuGet como Template.

Exemplos

  • Pesquise todos os modelos disponíveis em NuGet.org correspondentes à substring spa.

    dotnet new search spa

  • Pesquise todos os modelos disponíveis em NuGet.org que correspondam à substring we e suporte à linguagem F#.

    dotnet new search we --language "F#"

  • Pesquise modelos de item.

    dotnet new search --type item

  • Pesquise todos os modelos em C#, mostrando o tipo e as marcas na saída.

    dotnet new search --language "C#" --columns "type" --columns "tags"

Confira também