dotnet nova pesquisa

Artigo
05/03/2024

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

Nome

dotnet new search - Procura os modelos suportados pelo dotnet new On 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 procura modelos suportados pelo dotnet new on NuGet.org. Quando o <TEMPLATE_NAME> é especificado, procura modelos que contenham o nome especificado.

Nota

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

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

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 -h opção 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:

Pesquise todos os modelos disponíveis em NuGet.org que correspondam à substring "nós" e suportem a linguagem F#
```
dotnet new we --search --language "F#"
```

Argumentos

TEMPLATE_NAME

Se o argumento for especificado, apenas os modelos contendo <TEMPLATE_NAME> o nome do modelo ou nome abreviado serão mostrados. O argumento é obrigatório quando --author, --language, --package, --tag, ou --type opções não são especificadas.

Nota

A partir do .NET SDK 6.0.100, você pode colocar o <TEMPLATE_NAME> argumento após a --search opção. 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. Uma correspondência parcial é suportada.
--columns <COLUMNS>

A lista de colunas a serem exibidas na saída. As colunas suportadas são:
- author - O autor do modelo.
- language - A linguagem do modelo.
- tags - A lista de tags de modelo.
- type - O tipo de modelo.
O nome do modelo, o nome abreviado, 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

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

Imprime a ajuda para o comando de pesquisa. Disponível desde .NET SDK 7.0.100.
-lang|--language <language>

Filtra modelos com base no idioma suportado pelo 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álido para alguns modelos.

Nota

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

Filtra modelos com base na ID do pacote NuGet. Uma correspondência parcial é suportada.
--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.
--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 detalhamento do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal]e diag[nostic]. Disponível desde .NET SDK 7.0.100.

Nota

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

Exemplos

Pesquise todos os modelos disponíveis em NuGet.org que correspondam à substring do spa .
```
dotnet new search spa
```
Pesquise todos os modelos disponíveis em NuGet.org que correspondam à substring we e suportem a linguagem F#.
```
dotnet new search we --language "F#"
```
Pesquise modelos de item.
```
dotnet new search --type item
```

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

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

Partilhar via