共用方式為


快速入門:搭配 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 9YouTube 上尋找更多 NuGet 影片。

下一步

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