共用方式為

dotnet new search

  • 發行項

本文適用於： ✔️ .NET Core 5.0.300 SDK 與更新版本

名稱

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]

描述

dotnet new search 命令會在 NuGet.org 上搜尋 dotnet new 支援的範本。指定 <TEMPLATE_NAME> 時，搜尋包含指定名稱的範本。

注意

自 .NET 7 SDK 起，dotnet new 語法進行了下列變更：

  • --list、--search、--install 與 --uninstall 選項變成 list、search、install 與 uninstall 子命令。
  • --update-apply 選項變成了 update 子命令。
  • 如要使用 --update-check，請搭配使用 update 子命令和 --check-only 選項。

先前版本中可用的其他選項仍可與各自的子命令搭配使用。 如需每項子命令的個別說明，可透過 -h 或 --help 選項取得：dotnet new <subcommand> --help 會列出子命令的所有支援選項。

此外，dotnet new 現可使用 TAB 鍵自動完成。 這項功能支援完成已安裝範本的名稱，以及所選範本提供的選項。 若要為 .NET SDK 啟用 TAB 鍵自動完成，請參閱啟用 TAB 鍵自動完成。

舊語法的範例：

  • 搜尋 NuGet.org 中與 "we" 子字串相符且支援 F# 語言的所有可用範本

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

引數

  • TEMPLATE_NAME

    若指定引數，則只會顯示範本名稱或簡短名稱中包含 <TEMPLATE_NAME> 的範本。 未指定 、--language、--package、 --tag或 --type 選項時--author，自變數是必要自變數。

    注意

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

    列印 search 命令的說明。 自 .NET SDK 7.0.100 起提供使用。

  • -lang|--language <language>

    根據範本所支援的語言篩選範本。 接受的語言會因範本而異，可能的語言為 C#、F#、VB、SQL、JSON、TypeScript 等等。 並非所有範本都適用。

    注意

    某些殼層會將 # 解譯為特殊字元。 在這些情況下，請用引號括住語言參數值。 例如： dotnet new --search --language "F#" 。

  • --package <PACKAGE>

    根據 NuGet 套件識別碼篩選範本。 支援部分比對。

  • --tag <TAG>

    根據範本標籤篩選範本。 如要選取範本，該範本必須至少有一個完全符合準則的標籤。

  • --type <TYPE>

    根據範本類型篩選範本。 預先定義的值為 project、item 和 solution。

  • -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 中與 we 子字串相符且支援 F# 語言的所有可用範本。

    dotnet new search we --language "F#"

  • 搜尋項目範本。

    dotnet new search --type item

  • 搜尋所有 C# 範本，並在輸出中顯示類型和標籤。

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

另請參閱