dotnet new search

  • Artikel

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

Name

dotnet new search– sucht nach den Vorlagen, die von dotnet new auf NuGet.org unterstützt werden.

Übersicht

dotnet new search <TEMPLATE_NAME>

dotnet new search [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language {"C#"|"F#"|VB}]
    [--package <PACKAGE>] [--tag <TAG>] [--type <TYPE>]
    [--columns <COLUMNS>] [--columns-all]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Beschreibung

Der Befehl dotnet new search sucht auf NuGet.org nach Vorlagen, die von dotnet new unterstützt werden. Wenn <TEMPLATE_NAME> angegeben ist, sucht er nach Vorlagen, die den angegebenen Namen enthalten.

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:

  • Suche nach allen auf NuGet.org verfügbaren Vorlagen, die mit der Teilzeichenfolge „we“ übereinstimmen und die Sprache F# unterstützen.

    dotnet new we --search --language "F#"

Argumente

  • TEMPLATE_NAME

    Wenn dieses Argument angegeben wird, werden nur die Vorlagen angezeigt, die <TEMPLATE_NAME> im Vorlagennamen oder Kurznamen enthalten. Das Argument ist obligatorisch, wenn die Optionen --author, --language, --package, --tag oder --type nicht angegeben werden.

    Hinweis

    Ab .NET SDK 6.0.100 können Sie das Argument <TEMPLATE_NAME> hinter die Option --search setzen. dotnet new --search web liefert beispielsweise das gleiche Ergebnis wie dotnet new web --search. Die Verwendung mehrerer Argumente ist nicht zulässig.

Optionen

  • --author <AUTHOR>

    Filtert Vorlagen basierend auf dem Vorlagenautor. Eine teilweise Übereinstimmung wird unterstützt.

  • --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.

    Vorlagenname, Kurzname, Paketname und Gesamtanzahl der Downloads werden immer angezeigt. Die Standardliste der Spalten umfasst Vorlagenname, Kurzname, Autor, Sprache, Paket und Gesamtanzahl der Downloads. Dies entspricht der Angabe --columns=author,language.

  • --columns-all

    Zeigt alle Spalten in der Ausgabe an.

  • -d|--diagnostics

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

  • -h|--help

    Zeigt Hilfe für den Befehl „search“ an. 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 --search --language "F#".

  • --package <PACKAGE>

    Filtert Vorlagen basierend auf der NuGet-Paket-ID. Eine teilweise Übereinstimmung wird unterstützt.

  • --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.

  • --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.

Hinweis

Um sicherzustellen, dass das Vorlagenpaket im Ergebnis von dotnet new --search angezeigt wird, legen Sie den NuGet-Pakettyp auf Template fest.

Beispiele

  • Suche nach allen auf NuGet.org verfügbaren Vorlagen, die mit der Teilzeichenfolge spa übereinstimmen.

    dotnet new search spa

  • Suche nach allen auf NuGet.org verfügbaren Vorlagen, die mit der Teilzeichenfolge we übereinstimmen und die Sprache F# unterstützen.

    dotnet new search we --language "F#"

  • Suche nach Elementvorlagen.

    dotnet new search --type item

  • Suche nach allen C#-Vorlagen und Anzeige von Typ und Tags in der Ausgabe.

    dotnet new search --language "C#" --columns "type,tags"

Siehe auch