dotnet package search

本文適用於： ✔️.NET 8.0.2xx SDK 和更新版本

名稱

dotnet package search - 搜尋 NuGet 套件。

概要

dotnet package search <SEARCH TERM> [--configfile <FILE>] [--exact-match] [--format <FORMAT OPTION>]
    [--interactive] [--prerelease] [--skip <NUMBER>] [--source <SOURCE>] [--take <NUMBER>]
    [--verbosity <VERBOSITY VALUE>]

dotnet package search -h|--help

描述

命令 dotnet package search 會搜尋 NuGet 套件。

引數

• search terms

  指定要篩選結果的搜尋字詞。 使用此自變數來搜尋符合所提供查詢的套件。 範例：dotnet package search json。

選項。

• --configfile

  NuGet 組態檔。 若已指定，僅會使用此檔案中的設定。 若未指定，則將使用當前目錄中組態檔的階層。 如需詳細資訊，請參閱常見的 NuGet 設定。

• --exact-match

  此選項會將搜尋範圍縮小為只包含標識碼完全符合指定搜尋字詞的套件，有效地篩選掉任何部分相符專案。 它提供已識別套件之所有可用版本的精簡清單。 要忽略的原因 --take 和 --skip 選項。 利用此選項來顯示指定套件的所有可用版本。

• --format

  格式選項為 table 和 json。 預設值為 table。

• --interactive

  允許命令停止並等候使用者輸入或動作 (例如完成驗證)。

• --prerelease

  允許顯示發行前版本套件。

• --skip

  要略過的分頁結果數目。 預設值是 0。

• --source <SOURCE>

  要搜尋的套件來源。 您可以傳遞多個 --source 選項來搜尋多個套件來源。

• --take

  要傳回的結果數目。 預設值為 20。

• --verbosity

  在輸出中顯示這個詳細資料量： normal、 minimal或 detailed。 預設值為 normal。

• -?|-h|--help

  列印如何使用命令的描述。

範例

• 搜尋 NuGet.org 符合搜尋字詞 「Newtonsoft.Json」 的套件，並將輸出轉譯為最多 20 個套件的數據表：

  dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json
  

      Source: https://api.nuget.org/v3/index.json
      | Package ID                                  | Latest Version | Owners | Downloads       |
      |---------------------------------------------|----------------|--------|-----------------|
      | Newtonsoft.Json                             | 13.0.3         |        | 3,829,822,911   |
      |---------------------------------------------|----------------|--------|-----------------|
      | Newtonsoft.Json.Bson                        | 1.0.2          |        | 554,641,545     |
      |---------------------------------------------|----------------|--------|-----------------|
      | Newtonsoft.Json.Schema                      | 3.0.15         |        | 39,648,430      |
      |---------------------------------------------|----------------|--------|-----------------|
      | Microsoft.AspNetCore.Mvc.NewtonsoftJson     | 7.0.12         |        | 317,067,823     |
      |---------------------------------------------|----------------|--------|-----------------|
      ...
  

• 搜尋 NuGet.org 符合搜尋字詞 「Newtonsoft.Json」 的套件，並將輸出轉譯為 json。

  dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --format json
  

      {
      "version": 2,
      "problems": [],
      "searchResult": [
          {
          "sourceName": "https://api.nuget.org/v3/index.json",
          "packages": [
              {
              "id": "Newtonsoft.Json",
              "latestVersion": "13.0.3",
              "totalDownloads": 4456137550,
              "owners": "dotnetfoundation, jamesnk, newtonsoft"
              },
              {
              "id": "Newtonsoft.Json.Bson",
              "latestVersion": "1.0.2",
              "totalDownloads": 655362732,
              "owners": "dotnetfoundation, jamesnk, newtonsoft"
              },
              {
              "id": "Newtonsoft.Json.Schema",
              "latestVersion": "3.0.15",
              "totalDownloads": 46062119,
              "owners": "jamesnk, newtonsoft"
              },
              {
              "id": "Microsoft.AspNetCore.Mvc.NewtonsoftJson",
              "latestVersion": "8.0.3",
              "totalDownloads": 372202749,
              "owners": "aspnet, dotnetframework, Microsoft"
              },
              {
              "id": "Newtonsoft.Json.Encryption",
              "latestVersion": "2.2.0",
              "totalDownloads": 113101,
              "owners": "simoncropp"
              }
          ]
          }
      ]
      }
  

• 使用搜尋字詞 「Newtonsoft.Json」 搜尋套件 NuGet.org，只顯示兩個結果，並略過搜尋結果中的第一個套件：

  dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --skip 1 --take 2
  

      Source: https://api.nuget.org/v3/index.json
      | Package ID                                  | Latest Version | Owners | Downloads       |
      |---------------------------------------------|----------------|--------|-----------------|
      | Newtonsoft.Json.Bson                        | 1.0.2          |        | 554,641,545     |
      | Newtonsoft.Json.Schema                      | 3.0.15         |        | 39,648,430      |
  

• 搜尋完全符合 「Newtonsoft.Json」 的套件，並列出其所有可用的版本，忽略任何包含 “Newtonsoft.Json” 的套件作為其名稱或描述的一部分，但不符合它：

  dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --exact-match
  

      Source: https://api.nuget.org/v3/index.json
      | Package ID                                  | Version | Owners | Downloads       |
      |---------------------------------------------|---------|--------|-----------------|
      | Newtonsoft.Json                             | 13.0.3  |        | 3,829,822,911   |