Teilen über

dotnet new list

Dieser Artikel gilt für: ✔️ .NET 6 SDK und höhere Versionen

Name

dotnet new list - Liste der verfügbaren Vorlagen für die Ausführung mit dotnet new.

Zusammenfassung

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

Der dotnet new list Befehl listet die verfügbaren Vorlagen auf, die mit dotnet new. Wenn die <TEMPLATE_NAME> angegeben ist, werden Vorlagen mit dem angegebenen Namen aufgelistet. Diese Option listet nur Standard- und installierte Vorlagen auf. Um Vorlagen in NuGet zu finden, die Sie lokal installieren können, verwenden Sie den search Befehl.

Ab .NET SDK 7.0.100 list werden möglicherweise nicht alle auf dem Computer installierten Vorlagen angezeigt. Das Ergebnis von Vorlageneinschränkungen wird berücksichtigt, und die vorlagen, die nicht verwendet werden können, werden nicht angezeigt. Um die Anzeige aller Vorlagen zu erzwingen, verwenden Sie die --ignore-constraints Option.

Hinweis

Ab dem .NET 7 SDK hat sich die syntax der dotnet new geändert:

  • Die Optionen --list, --search, --installund --uninstall wurden zu list, search, installund uninstall Unterbefehlen.
  • Die Option --update-apply wurde zum update Unterbefehl.
  • Um --update-checkzu verwenden, verwenden Sie den unterbefehl update mit der Option --check-only.

Andere Optionen, die zuvor verfügbar waren, stehen weiterhin zur Verwendung mit den jeweiligen Unterbefehlen zur Verfügung. Separate Hilfe für jeden Unterbefehl steht über die Option -h oder --help zur Verfügung: dotnet new <subcommand> --help listet alle unterstützten Optionen für den Unterbefehl auf.

Darüber hinaus ist der Abschluss der Registerkarte jetzt für dotnet newverfügbar. Er unterstützt den Abschluss für installierte Vorlagennamen und für die von einer ausgewählten Vorlage bereitgestellten Optionen. Informationen zum Aktivieren des Abschlusses der Registerkarte für das .NET SDK finden Sie unter Aktivieren des Abschlusses der Registerkarte.

Beispiele für die alte Syntax:

  • Auflisten aller Single Page Application (SPA)-Vorlagen:

    • seit .NET SDK 6.0.100
    dotnet new --list spa
    • vor .NET SDK 6.0.100
    dotnet new spa --list

Arguments

  • TEMPLATE_NAME

    Wenn das Argument angegeben ist, werden nur die Vorlagen angezeigt, die im Vorlagennamen oder kurznamen enthalten <TEMPLATE_NAME> sind.

Options

  • --author <AUTHOR>

    Filtert Vorlagen basierend auf dem Vorlagenautor. Partielle Übereinstimmung wird unterstützt. Verfügbar seit .NET SDK 5.0.300.

  • --columns <COLUMNS>

    Durch Trennzeichen getrennte Liste der Spalten, die in der Ausgabe angezeigt werden sollen. Die unterstützten Spalten sind:

    • language – Eine durch Trennzeichen getrennte Liste von Sprachen, die von der Vorlage unterstützt werden.
    • tags - Die Liste der Vorlagentags.
    • author - Der Vorlagenautor.
    • type - Der Vorlagentyp: Projekt oder Element.

    Der Vorlagenname und der Kurzname werden immer angezeigt. Die Standardliste der Spalten ist Vorlagenname, Kurzname, Sprache und Tags. Diese Liste entspricht der Angabe --columns=language,tagsvon . Verfügbar seit .NET SDK 5.0.300.

  • --columns-all

    Zeigt alle Spalten in der Ausgabe an. Verfügbar seit .NET SDK 5.0.300.

  • -d|--diagnostics

    Aktiviert die Diagnoseausgabe. Verfügbar seit .NET SDK 7.0.100.

  • -?|-h|--help

    Gibt eine Beschreibung zur Verwendung des Befehls aus.

  • --ignore-constraints

    Deaktiviert die Überprüfung, ob die Vorlage die auszuführenden Einschränkungen erfüllt. Verfügbar seit .NET SDK 7.0.100.

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

    Filtert Vorlagen basierend auf der sprache, die von der Vorlage unterstützt wird. Die akzeptierte Sprache variiert je nach Vorlage. Für einige Vorlagen nicht gültig.

    Hinweis

    Einige Shells interpretieren # als Sonderzeichen. In diesen Fällen müssen Sie den Sprachparameterwert in Klammern setzen. Beispiel: dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    Speicherort für die generierte Ausgabe. Der Standardwert ist das aktuelle Verzeichnis. Für den Listenbefehl kann es erforderlich sein, das Ausgabeverzeichnis anzugeben, um Einschränkungen für die Vorlage ordnungsgemäß auszuwerten. Verfügbar seit .NET SDK 7.0.100.

  • --project <PROJECT_PATH>

    Das Projekt, dem die Vorlage hinzugefügt wird. Für den Listenbefehl kann es erforderlich sein, das Projekt anzugeben, dem die Vorlage hinzugefügt wird, um Einschränkungen für die Vorlage ordnungsgemäß auszuwerten. Verfügbar seit .NET SDK 7.0.100.

  • --tag <TAG>

    Filtert Vorlagen basierend auf Vorlagentags. Um ausgewählt zu werden, muss eine Vorlage über mindestens ein Tag verfügen, das genau den Kriterien entspricht. Verfügbar seit .NET SDK 5.0.300.

  • --type <TYPE>

    Filtert Vorlagen basierend auf dem Vorlagentyp. Vordefinierte Werte sind project, itemund solution.

  • -v|--verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad für den Befehl fest. Zulässige Werte sind q[uiet], m[inimal], n[ormal], d[etailed] und diag[nostic]. Weitere Informationen finden Sie unter LoggerVerbosity.

Examples

  • Alle Vorlagen auflisten

    dotnet new list

  • Auflisten aller Single Page Application (SPA)-Vorlagen:

    dotnet new list spa

  • Listet alle Vorlagen auf, die der Teilzeichenfolge entsprechen.

    dotnet new list we

  • Listet alle Vorlagen auf, die der Teilzeichenfolge entsprechen, die die F#-Sprache unterstützen.

    dotnet new list we --language "F#"

  • Alle Elementvorlagen auflisten.

    dotnet new list --type item

  • Listet alle C#-Vorlagen auf, die den Autor und den Typ in der Ausgabe anzeigen.

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

Siehe auch

  • Last updated on