Mulai cepat: Menginstal dan menggunakan paket dengan dotnet CLI

  • Artikel

Paket NuGet berisi kode biner yang dikompilasi yang disediakan pengembang untuk digunakan pengembang lain dalam proyek mereka. Untuk informasi selengkapnya, lihat Apa itu NuGet. Mulai cepat ini menjelaskan cara menginstal paket Newtonsoft.Json NuGet populer ke dalam proyek .NET dengan menggunakan perintah tambahkan paket dotnet.

Anda merujuk ke paket yang diinstal dalam kode dengan using <namespace> direktif, di mana <namespace> sering kali adalah nama paket. Anda kemudian dapat menggunakan API paket dalam proyek Anda.

Tip

Telusuri nuget.org/packages untuk menemukan paket yang dapat Anda gunakan kembali di aplikasi Anda sendiri. Anda dapat mencari langsung di https://nuget.org, atau menemukan dan menginstal paket dari dalam Visual Studio. Untuk informasi selengkapnya, lihat Menemukan dan mengevaluasi paket NuGet untuk proyek Anda.

Prasyarat

  • .NET SDK, yang menyediakan dotnet alat baris perintah. Mulai dari Visual Studio 2017, CLI dotnet secara otomatis diinstal dengan beban kerja terkait .NET atau .NET Core.

Membuat proyek

Anda dapat menginstal paket NuGet ke dalam proyek .NET. Untuk panduan ini, buat proyek konsol .NET sederhana dengan menggunakan dotnet CLI, sebagai berikut:

  1. Buat folder bernama Nuget.Quickstart untuk proyek.

  2. Buka perintah dan beralih ke folder baru.

  3. Buat proyek dengan menggunakan perintah berikut:

    dotnet new console

  4. Gunakan dotnet run untuk menguji aplikasi. Anda akan melihat output Hello, World!.

Menambahkan paket Newtonsoft.Json NuGet

  1. Gunakan perintah berikut untuk menginstal Newtonsoft.json paket:

    dotnet add package Newtonsoft.Json

  2. Setelah perintah selesai, buka file Nuget.Quickstart.csproj di Visual Studio untuk melihat referensi paket NuGet yang ditambahkan:

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

Menggunakan API Newtonsoft.Json di aplikasi

  1. Di Visual Studio, buka file Program.cs dan tambahkan baris berikut di bagian atas file:

    using Newtonsoft.Json;

  2. Tambahkan kode berikut untuk mengganti pernyataan 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. Simpan file, lalu buat dan jalankan aplikasi dengan menggunakan dotnet run perintah . Output adalah representasi JSON dari Account objek dalam kode:

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

Selamat atas penginstalan dan penggunaan paket NuGet pertama Anda!

Temukan video NuGet lainnya di Channel 9 dan YouTube.

Langkah berikutnya

Pelajari selengkapnya tentang menginstal dan menggunakan paket NuGet dengan CLI dotnet:

Menginstal dan menggunakan paket dengan menggunakan CLI dotnet