nova lista dotnet

Artigo
05/10/2023

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

Name

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

A partir do SDK .NET 7.0.100, o list comando poderá não mostrar todos os modelos instalados no computador. Tem em conta o resultado das restrições de modelo e os modelos que não podem ser utilizados não serão apresentados. Para forçar a apresentação de todos os modelos, utilize a opção --ignore-constraints .

Nota

A partir do SDK .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 utilizar --update-checko , utilize o update subcomando com a opção --check-only .

Outras opções que estavam disponíveis anteriormente ainda estão disponíveis para utilização com os respetivos subcomandos. A ajuda separada para cada subcomando está disponível através da opção -h ou --help : dotnet new <subcommand> --help lista todas as opções suportadas para o subcomando.

Além disso, a conclusão do separador está agora disponível para dotnet new. Suporta a conclusão de nomes de modelos instalados e para as opções que um modelo selecionado fornece. Para ativar a conclusão do separador para o SDK .NET, veja Ativar a conclusão do separador.

Exemplos da sintaxe antiga:

Listar todos os modelos de Aplicação de Página Única (SPA):
- desde o SDK .NET 6.0.100
```
dotnet new --list spa
```
- antes do SDK .NET 6.0.100
```
dotnet new spa --list
```

Argumentos

TEMPLATE_NAME

Se o argumento for especificado, só serão apresentados os modelos que <TEMPLATE_NAME> contêm o nome do modelo ou o nome abreviado.

Opções

--author <AUTHOR>

Filtra modelos com base no autor do modelo. A correspondência parcial é suportada. Disponível desde o SDK .NET 5.0.300.
--columns <COLUMNS>

Lista separada por vírgulas de colunas a apresentar na saída. As colunas suportadas são:
- language - Uma lista separada por vírgulas de idiomas suportados pelo modelo.
- tags - A lista de etiquetas de modelo.
- author - O autor do modelo.
- type - O tipo de modelo: projeto ou item.
O nome do modelo e o nome abreviado são sempre apresentados. A lista predefinida de colunas é nome de modelo, nome abreviado, idioma e etiquetas. Esta lista é equivalente a especificar --columns=language,tags. Disponível desde o SDK .NET 5.0.300.
--columns-all

Apresenta todas as colunas na saída. Disponível desde o SDK .NET 5.0.300.
-d|--diagnostics

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

Imprime ajuda para o comando de lista. Disponível desde o SDK .NET 7.0.100.
--ignore-constraints

Desativa a verificação se o modelo cumpre as restrições a executar. Disponível desde o SDK .NET 7.0.100.
-lang|--language {C#|F#|VB}

Filtra modelos com base no idioma suportado pelo modelo. O idioma aceite varia consondo o modelo. Não é válido para alguns modelos.

Nota

Algumas shells interpretam # como um caráter especial. Nesses casos, coloque o valor do parâmetro de idioma entre aspas. Por exemplo, dotnet new --list --language "F#".
-o|--output <OUTPUT_DIRECTORY>

Localização para colocar a saída gerada. A predefinição é o diretório atual. Para o comando de lista, poderá ser necessário especificar o diretório de saída para avaliar corretamente as restrições do modelo. Disponível desde o SDK .NET 7.0.100.
--project <PROJECT_PATH>

O projeto ao qual o modelo é adicionado. Para o comando de lista, poderá ser necessário especificar o projeto ao qual o modelo está a ser adicionado para avaliar corretamente as restrições do modelo. Disponível desde o SDK .NET 7.0.100.
--tag <TAG>

Filtra modelos com base em etiquetas de modelo. Para ser selecionado, um modelo tem de ter, pelo menos, uma etiqueta que corresponda exatamente aos critérios. Disponível desde o SDK .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 verbosidade do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal]e diag[nostic]. Disponível desde o SDK .NET 7.0.100.

Exemplos

Listar todos os modelos
```
dotnet new list
```
Listar todos os modelos de Aplicação de Página Única (SPA):
```
dotnet new list spa
```
Liste todos os modelos correspondentes à subcadeia we .
```
dotnet new list we
```
Liste todos os modelos correspondentes à subcadeia que suporta o idioma F#.
```
dotnet new list we --language "F#"
```
Listar todos os modelos de itens.
```
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"
```

Partilhar via