dotnet new list

  • Artikel

Dieser Artikel gilt für: ✔️ .NET Core 3.1 SDK und höher

Name

dotnet new list: Listet verfügbare Vorlagen auf, die mit dotnet new ausgeführt werden.

Übersicht

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]

Beschreibung

Der dotnet new list-Befehl listet verfügbare Vorlagen für die Verwendung mit dotnet new auf. Wenn für <TEMPLATE_NAME> ein Vorlagenname angegeben wird, werden Vorlagen aufgelistet, die diesen Namen enthalten. Diese Option listet nur Standardvorlagen und installierte Vorlagen auf. Wenn Sie nach Vorlagen in NuGet suchen möchten, die Sie lokal installieren können, verwenden Sie den search-Befehl.

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

Hinweis

Ab .NET 7 SDK hat sich die Syntax von dotnet new geändert:

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

Andere Optionen, die zuvor verfügbar waren, können weiterhin mit ihren jeweiligen Unterbefehlen verwendet werden. Gesonderte Hilfe für jeden Unterbefehl ist über die Option -h oder --help verfügbar: dotnet new <subcommand> --help listet alle unterstützten Optionen für den Unterbefehl auf.

Darüber hinaus ist die Vervollständigung mit der TAB-TASTE jetzt für dotnet new verfügbar. Es unterstützt die Vervollständigung für installierte Vorlagennamen und für die Optionen, die eine ausgewählte Vorlage bereitstellt. Informationen zum Aktivieren der Vervollständigung mit der TAB-TASTE für das .NET SDK finden Sie unter Aktivieren der Vervollständigung mit der TAB-TASTE.

Beispiele für die alte Syntax:

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

    • Seit .NET SDK 6.0.100
    dotnet new --list spa
    • Vor .NET SDK 6.0.100
    dotnet new spa --list

Argumente

  • TEMPLATE_NAME

    Wenn dieses Argument angegeben wird, werden nur die Vorlagen angezeigt, die <TEMPLATE_NAME> im Vorlagennamen oder Kurznamen enthalten.

Optionen

  • --author <AUTHOR>

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

  • --columns <COLUMNS>

    Durch Kommas getrennte Liste von Spalten, die in der Ausgabe angezeigt werden sollen. Folgende Spalten werden unterstützt:

    • language: Eine durch Kommas 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 umfasst Vorlagenname, Kurzname, Sprache und Tags. Dies entspricht der Angabe --columns=language,tags. 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

    Ermöglicht die diagnostische Ausgabe. Verfügbar seit .NET SDK 7.0.100.

  • -h|--help

    Druckt Hilfe für den list-Befehl. Verfügbar seit .NET SDK 7.0.100.

  • --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 von der Vorlage unterstützten Sprache. 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. Beispielsweise dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    Speicherort für die generierte Ausgabe. Der Standardwert ist das aktuelle Verzeichnis. Für den list-Befehl muss möglicherweise das Ausgabeverzeichnis angegeben werden, um die 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 list-Befehl muss möglicherweise das Projekt angegeben werden, dem die Vorlage hinzugefügt wird, um die Einschränkungen für die Vorlage ordnungsgemäß auszuwerten. Verfügbar seit .NET SDK 7.0.100.

  • --tag <TAG>

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

  • --type <TYPE>

    Filtert Vorlagen basierend auf dem Vorlagentyp. Die Werte project, item und solution sind vordefiniert.

  • -v|--verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad für den Befehl fest. Zulässige Werte sind q[uiet], m[inimal], n[ormal] und diag[nostic]. Verfügbar seit .NET SDK 7.0.100.

Beispiele

  • Auflisten aller Vorlagen:

    dotnet new list

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

    dotnet new list spa

  • Auflisten aller Vorlagen, für die sich eine Übereinstimmung mit der Teilzeichenfolge we ergibt:

    dotnet new list we

  • Auflisten aller Vorlagen, die eine Übereinstimmung mit der Teilzeichenfolge we aufweisen und die Sprache F# unterstützen:

    dotnet new list we --language "F#"

  • Auflisten aller Elementvorlagen:

    dotnet new list --type item

  • Auflisten aller C#-Vorlagen unter Angabe des Autors und Typs in der Ausgabe:

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

Siehe auch