Bagikan melalui


Mulai cepat: Menginstal dan menggunakan paket dengan dotnet CLI

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

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

Petunjuk / Saran

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 jendela command prompt dan pindah 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 selanjutnya

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