快速入門：搭配 dotnet CLI 安裝和使用套件

  • 發行項

NuGet 套件包含已編譯的二進位程式代碼，開發人員可讓其他開發人員在其專案中使用。 如需詳細資訊，請參閱 什麼是 NuGet。 本快速入門說明如何使用 dotnet add package 命令，將熱門的 Newtonsoft.Json NuGet 套件安裝到 .NET 專案中。

您可以使用 指示詞在程式碼 using <namespace> 中參考已安裝的套件，其中 <namespace> 通常是套件名稱。 接著，您可以在專案中使用套件的 API。

提示

瀏覽 nuget.org/packages 尋找可在您自己的應用程式中重複使用的套件。 您可以直接在 https://nuget.org搜尋 ，或從 Visual Studio 中尋找並安裝套件。 如需詳細資訊，請參閱 尋找和評估專案的 NuGet 套件。

必要條件

  • .NET SDK，提供dotnet命令行工具。 從 Visual Studio 2017 開始，dotnet CLI 會自動安裝任何 .NET 或 .NET Core 相關工作負載。

建立專案

您可以將 NuGet 套件安裝到 .NET 專案中。 在本逐步解說中，使用 dotnet CLI 建立簡單的 .NET 控制台專案，如下所示：

  1. 為專案建立名為 Nuget.Quickstart 的資料夾。

  2. 開啟命令提示字元並切換至新的資料夾。

  3. 使用下列命令建立專案：

    dotnet new console

  4. 用來 dotnet run 測試應用程式。 您應該會看到輸出 Hello, World!。

新增 Newtonsoft.Json NuGet 套件

  1. 使用下列命令來安裝 Newtonsoft.json 套件：

    dotnet add package Newtonsoft.Json

  2. 命令完成之後，在 Visual Studio 中開啟 Nuget.Quickstart.csproj 檔案，以查看新增的 NuGet 套件參考：

    <ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
</ItemGroup>

在應用程式中使用 Newtonsoft.Json API

  1. 在 Visual Studio 中 ，開啟 Program.cs 檔案，並在檔案頂端新增下列這一行：

    using Newtonsoft.Json;

  2. 新增下列程式代碼以取代 Console.WriteLine("Hello, World!"); 語句：

    namespace Nuget.Quickstart
{
    public class Account
    {
        public string? Name { get; set; }
        public string? Email { get; set; }
        public DateTime DOB { get; set; }
    }
    internal class Program
    {
        static void Main(string[] args)
        {
            Account account = new Account
            {
                Name = "John Doe",
                Email = "john@nuget.org",
                DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
            };

            string json = JsonConvert.SerializeObject(account, Formatting.Indented);
            Console.WriteLine(json);
        }
    }
}

  3. 儲存盤案，然後使用 命令建置並執行應用程式 dotnet run 。 輸出是程式代碼中物件的 JSON 表示 Account 法：

    {
  "Name": "John Doe",
  "Email": "john@nuget.org",
  "DOB": "1980-02-20T00:00:00Z"
}

恭喜，您安裝並使用了您的第一個 NuGet 套件！

在 Channel 9 和 YouTube 上尋找更多 NuGet 影片。

下一步

深入瞭解如何搭配 dotnet CLI 安裝和使用 NuGet 套件：

使用 dotnet CLI 安裝和使用套件