Sdílet prostřednictvím

dotnet new list

Tento článek se vztahuje na: ✔️ .NET 6 SDK a novější verze

Název

dotnet new list - Uvádí dostupné šablony, které se mají spouštět pomocí dotnet new.

Přehled

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, které se mají použít s dotnet new. <Pokud je zadaný TEMPLATE_NAME>, zobrazí se seznam šablon obsahující zadaný název. Tato možnost obsahuje pouze výchozí a nainstalované šablony. Pokud chcete najít šablony v NuGetu, které můžete nainstalovat místně, použijte search příkaz.

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

Poznámka:

Počínaje sadou .NET 7 SDK se změnila syntaxe dotnet new:

  • Možnosti --list, --search, --installa --uninstall se staly list, search, installa uninstall podpříkazy.
  • Možnost --update-apply se stala podpříkazem update.
  • Pokud chcete použít --update-check, použijte podpříkaz update s možností --check-only.

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

Kromě toho je nyní k dispozici dokončování tabulátoru pro dotnet new. Podporuje dokončování pro nainstalované názvy šablon a možnosti, které poskytuje vybraná šablona. Pokud chcete aktivovat dokončování karet pro sadu .NET SDK, přečtěte si téma Povolení dokončování tabulátoru.

Příklady staré syntaxe:

  • Výpis všech šablon jednostránkové aplikace (SPA):

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

Arguments

  • TEMPLATE_NAME

    Pokud je argument zadán, zobrazí se pouze šablony, které obsahují <TEMPLATE_NAME> název šablony nebo krátký název.

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>

    Čárkami oddělený seznam sloupců, které se mají zobrazit 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 je ekvivalentní k 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 popis použití příkazu.

  • --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, který šablona přijala, se liší. Některé šablony nejsou platné.

    Poznámka:

    Některá prostředí se interpretují # jako speciální znak. V těchto případech uzavřete hodnotu parametru jazyka 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ář pro správné vyhodnocení 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 zadat projekt, do kterého se šablona přidává, aby se správně vyhodnocovala omezení šablony. K dispozici od sady .NET SDK 7.0.100.

  • --tag <TAG>

    Filtruje šablony na základě značek šablon. Pokud chcete vybrat šablonu, 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], d[etailed]a diag[nostic]. Další informace najdete v tématu LoggerVerbosity.

Examples

  • Výpis všech šablon

    dotnet new list

  • Výpis všech šablon jednostránkové aplikace (SPA):

    dotnet new list spa

  • Vypíše všechny šablony odpovídající podřetědci.

    dotnet new list we

  • Vypíše všechny šablony odpovídající podřetězi, které podporují jazyk F#.

    dotnet new list we --language "F#"

  • Zobrazí seznam všech šablon položek.

    dotnet new list --type item

  • Zobrazte seznam všech šablon jazyka C# zobrazující autora a typ ve výstupu.

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

Viz také

  • Last updated on