nova pesquisa do dotnet

Artigo
05/03/2024

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"
```

Compartilhar via