Compartilhar via


nova pesquisa do dotnet

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

Nome

dotnet new search – pesquisa os modelos com dotnet new suporte no 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]

Description

O dotnet new search comando pesquisa modelos com dotnet new suporte no NuGet.org. Quando o <TEMPLATE_NAME> é especificado, pesquisa 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, --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:

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

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

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. O argumento é obrigatório quando--author, , --language, --package--tagou --type opções não são especificadas.

    Observação

    A partir do SDK do .NET 6.0.100, você pode colocar o <TEMPLATE_NAME> argumento 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 - O idioma 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 ele for uma origem confiável e a contagem total de downloads sempre são mostrados. A lista padrão de colunas é nome do modelo, nome curto, idioma, pacote, uma indicação se é uma origem confiável e total de downloads. Para especificar várias colunas, use a opção --columns 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 SDK do .NET 7.0.100.

  • -?|-h|--help

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

  • -lang|--language <language>

    Filtra modelos com base no idioma compatível com o modelo. O idioma aceito varia de acordo com o modelo, os idiomas 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 modelos com base na ID do pacote NuGet. Há suporte para uma correspondência parcial.

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

  • --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]e diag[nostic]. Disponível desde o SDK do .NET 7.0.100.

Observação

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

Exemplos

  • Pesquise todos os modelos disponíveis em NuGet.org correspondentes à subcadeia de caracteres de spa .

    dotnet new search spa
    
  • Pesquise todos os modelos disponíveis em NuGet.org que correspondam à subcadeia de caracteres e à linguagem F#.

    dotnet new search we --language "F#"
    
  • Pesquise modelos de item.

    dotnet new search --type item
    
  • Pesquise todos os modelos de C#, mostrando o tipo e as marcas na saída.

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

Consulte também