dotnet new search(创建新的搜索项)

本文适用于:✔️ .NET 6 SDK 及更高版本

Name

dotnet new search - 在 NuGet.org 上搜索支持的 dotnet new 模板。

概要

dotnet new search <TEMPLATE_NAME>

dotnet new search [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language <language>]
    [--package <PACKAGE>] [--tag <TAG>] [--type <TYPE>]
    [--columns <author|language|tags|type>] [--columns-all]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Description

dotnet new search 命令在 NuGet.org 上搜索支持的 dotnet new 模板。 <指定TEMPLATE_NAME> 后,搜索包含指定名称的模板。

注释

从 .NET 7 SDK 开始,dotnet new 语法已更改:

  • --list--search--install--uninstall 选项成为 listsearchinstalluninstall 子命令。
  • --update-apply 选项成为 update 子命令。
  • 若要使用 --update-check,请使用 update 子命令和 --check-only 选项。

以前可用的其他选项仍可用于各自的子命令。 可通过 -h--help 选项获取每个子命令的单独帮助:dotnet new <subcommand> --help 列出了子命令的所有支持选项。

此外,选项卡完成现在可用于 dotnet new。 它支持完成已安装的模板名称和所选模板提供的选项。 若要激活 .NET SDK 的选项卡完成,请参阅 启用选项卡完成

旧语法的示例:

  • 搜索 NuGet.org 匹配“we”子字符串并支持 F# 语言的所有模板

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

Arguments

  • TEMPLATE_NAME

    如果指定了参数,则仅显示模板 <TEMPLATE_NAME> 名称或短名称中包含的模板。 如果未指定 、--author--language--package--tag选项,则参数是必需的--type

    注释

    从 .NET SDK 6.0.100 开始,可以将参数放在 <TEMPLATE_NAME> 选项后面 --search 。 例如, dotnet new --search web 提供与 ..相同的结果 dotnet new web --search。 不允许使用多个参数。

选项

  • --author <AUTHOR>

    基于模板作者筛选模板。 支持部分匹配。

  • --columns <COLUMNS>

    要在输出中显示的列列表。 支持的列包括:

    • author - 模板作者。
    • language - 模板语言。
    • tags - 模板标记列表。
    • type - 模板类型。

    模板名称、短名称、包名称、指示是否为受信任的源,并且始终显示总下载计数。 列的默认列表是模板名称、短名称、语言、包、指示是否为受信任的源和总下载。 若要指定多个列,请多次使用 --columns 该选项。

  • --columns-all

    显示输出中的所有列。

  • -d|--diagnostics

    启用诊断输出。 自 .NET SDK 7.0.100 起可用。

  • -?|-h|--help

    打印出有关如何使用命令的说明。

  • -lang|--language <language>

    根据模板支持的语言筛选模板。 接受的语言因模板而异,可能的语言为 C#、F#、VB、SQL、JSON、TypeScript 等。 对于某些模板无效。

    注释

    某些 shell 将 # 解释为特殊字符。 在这些情况下,请将语言参数值括在引号中。 例如,dotnet new --search --language "F#"

  • --package <PACKAGE>

    基于 NuGet 包 ID 筛选模板。 支持部分匹配。

  • --tag <TAG>

    基于模板标记筛选模板。 若要选择,模板必须至少有一个与条件完全匹配的标记。

  • --type <TYPE>

    基于模板类型筛选模板。 预定义的值是 projectitemsolution

  • -v|--verbosity <LEVEL>

    设置命令的详细级别。 允许的值为 q[uiet]m[inimal]n[ormal]diag[nostic]。 自 .NET SDK 7.0.100 起可用。

注释

若要确保模板包出现在结果中 dotnet new --search请将 NuGet 包类型 设置为 Template

例子

  • 搜索 NuGet.org 与 spa 子字符串匹配的所有模板。

    dotnet new search spa
    
  • 搜索 NuGet.org 匹配 我们 子字符串并支持 F# 语言的所有模板。

    dotnet new search we --language "F#"
    
  • 搜索项模板。

    dotnet new search --type item
    
  • 搜索所有 C# 模板,其中显示了输出中的类型和标记。

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

另请参阅