dotnet new list

  • Článek

Tento článek se týká sady ✔️ .NET Core 3.1 SDK a novějších verzí.

Name

dotnet new list – Vypíše dostupné šablony, které se mají spustit pomocí dotnet new.

Synopse

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

Příkaz dotnet new list zobrazí seznam dostupných šablon pro použití s příkazem dotnet new. <Pokud je TEMPLATE_NAME> zadaný, zobrazí seznam šablon obsahující zadaný název. Tato možnost vypíše jenom výchozí a nainstalované šablony. K vyhledání šablon v NuGetu, které můžete nainstalovat místně, použijte search příkaz .

Počínaje sadou .NET SDK 7.0.100 list nemusí příkaz zobrazit všechny šablony nainstalované na počítači. Bere v úvahu výsledek omezení šablon a šablony, které nelze použít, se nezobrazí. Pokud chcete vynutit zobrazení všech šablon, použijte --ignore-constraints možnost .

Poznámka

Od sady .NET 7 SDK se dotnet new syntaxe změnila:

  • Z --listmožností , --search, --installa --uninstall se staly listpodpříkazy , searchinstall, a uninstall .
  • Možnost --update-apply se stala dílčím update příkazem.
  • Pokud chcete použít --update-check, použijte update podpříkaz s --check-only možností .

Další možnosti, které byly k dispozici dříve, jsou stále k dispozici pro použití s příslušnými dílčími příkazy. Samostatná nápověda pro každý podpříkaz je k dispozici prostřednictvím -h možnosti nebo --help : dotnet new <subcommand> --help obsahuje seznam všech podporovaných možností podpříkazu.

Kromě toho je teď k dispozici dokončování tabulátoru pro dotnet new. Podporuje dokončování názvů nainstalovaných šablon a možností, které vybraná šablona nabízí. Pokud chcete aktivovat dokončování tabulátoru pro sadu .NET SDK, přečtěte si téma Povolení dokončování karet.

Příklady staré syntaxe:

  • Vypsat všechny šablony jednostránkových aplikací (SPA):

    • od verze .NET SDK 6.0.100
    dotnet new --list spa
    • před .NET SDK 6.0.100
    dotnet new spa --list

Argumenty

  • TEMPLATE_NAME

    Pokud je argument zadaný, zobrazí se pouze šablony, které jsou v <TEMPLATE_NAME> názvu šablony nebo v krátkém názvu.

Možnosti

  • --author <AUTHOR>

    Filtruje šablony na základě autora šablony. Podporuje se částečná shoda. K dispozici od sady .NET SDK 5.0.300.

  • --columns <COLUMNS>

    Seznam sloupců oddělených čárkami, které se zobrazí ve výstupu. Podporované sloupce jsou:

    • language – Čárkami oddělený seznam jazyků podporovaných šablonou.
    • tags – Seznam značek šablon.
    • author – Autor šablony.
    • type – Typ šablony: projekt nebo položka.

    Vždy se zobrazí název šablony a krátký název. Výchozí seznam sloupců je název šablony, krátký název, jazyk a značky. Tento seznam odpovídá zadání --columns=language,tags. K dispozici od sady .NET SDK 5.0.300.

  • --columns-all

    Zobrazí všechny sloupce ve výstupu. K dispozici od sady .NET SDK 5.0.300.

  • -d|--diagnostics

    Povolí výstup diagnostiky. K dispozici od sady .NET SDK 7.0.100.

  • -h|--help

    Vytiskne nápovědu k příkazu list. K dispozici od sady .NET SDK 7.0.100.

  • --ignore-constraints

    Zakáže kontrolu, jestli šablona splňuje omezení, která se mají spustit. K dispozici od sady .NET SDK 7.0.100.

  • -lang|--language {C#|F#|VB}

    Filtruje šablony na základě jazyka podporovaného šablonou. Jazyk akceptovaných šablon se liší podle šablony. Není platné pro některé šablony.

    Poznámka

    Některé prostředí se interpretují # jako speciální znak. V těchto případech hodnotu parametru jazyka uzavřete do uvozovek. Například, dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    Umístění pro umístění vygenerovaného výstupu Výchozí je aktuální adresář. Pro příkaz list může být nutné zadat výstupní adresář, aby bylo možné správně vyhodnotit omezení šablony. K dispozici od sady .NET SDK 7.0.100.

  • --project <PROJECT_PATH>

    Projekt, do kterého je šablona přidána. Pro příkaz list může být potřeba určit projekt, do kterého se šablona přidává, aby bylo možné správně vyhodnotit omezení šablony. K dispozici od sady .NET SDK 7.0.100.

  • --tag <TAG>

    Filtruje šablony na základě značek šablon. Aby bylo možné šablonu vybrat, musí mít alespoň jednu značku, která přesně odpovídá kritériím. K dispozici od sady .NET SDK 5.0.300.

  • --type <TYPE>

    Filtruje šablony na základě typu šablony. Předdefinované hodnoty jsou project, itema solution.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], m[inimal], n[ormal]a diag[nostic]. K dispozici od sady .NET SDK 7.0.100.

Příklady

  • Vypsat všechny šablony

    dotnet new list

  • Vypsat všechny šablony jednostránkových aplikací (SPA):

    dotnet new list spa

  • Vypíše všechny šablony, které odpovídají podřetěžci we .

    dotnet new list we

  • Vypište všechny šablony odpovídající podřetěžci , které podporují jazyk F#.

    dotnet new list we --language "F#"

  • Vypsat všechny šablony položek

    dotnet new list --type item

  • Vypíše všechny šablony jazyka C# a ve výstupu se zobrazí autor a typ.

    dotnet new list --language "C#" --columns "author,type"

Viz také