Mulai cepat: Menginstal dan menggunakan paket NuGet di Visual Studio (hanya Windows)

Dalam panduan cepat ini, Anda akan menggunakan Microsoft Visual Studio untuk menginstal dan menggunakan paket NuGet dalam proyek. Paket NuGet berisi kode yang dapat digunakan kembali yang disediakan pengembang lain untuk Anda gunakan dalam proyek Anda.

Anda dapat menginstal paket NuGet dalam proyek Visual Studio dengan menggunakan NuGet Package Manager, konsol Package Manager, atau antarmuka baris perintah (CLI) .NET . Panduan mulai cepat ini memperlihatkan cara menggunakan Pengelola Paket NuGet dan Konsol Pengelola Paket untuk menginstal paket. Anda mengikuti langkah-langkah untuk membuat proyek Windows Presentation Foundation (WPF) yang menggunakan paket Newtonsoft.Json populer. Proses yang sama berlaku untuk proyek .NET lainnya.

Artikel ini hanya untuk pengguna Windows. Jika Anda menggunakan Visual Studio untuk Mac, lihat Install dan gunakan paket di Visual Studio untuk Mac.

Saran

Untuk menemukan paket NuGet, mulailah dengan nuget.org. Menelusuri nuget.org adalah bagaimana pengembang .NET biasanya menemukan komponen yang dapat mereka gunakan kembali di aplikasi mereka sendiri. Anda dapat melakukan pencarian nuget.org secara langsung atau menemukan dan menginstal paket dalam Visual Studio seperti yang ditunjukkan dalam artikel ini. Untuk informasi selengkapnya, lihat Menemukan dan mengevaluasi paket NuGet untuk proyek Anda.

Prasyarat

  • Instal Visual Studio 2026 dengan beban kerja pengembangan desktop .NET.

    Anda dapat menginstal edisi Komunitas 2026 secara gratis dari visualstudio.microsoft.com, atau Anda dapat menggunakan edisi Profesional atau Perusahaan.

Membuat proyek

Anda dapat menginstal paket NuGet ke dalam proyek .NET apa pun jika paket tersebut mendukung kerangka kerja target yang sama dengan proyek. Dalam panduan awal ini, Anda membuat proyek Aplikasi WPF.

Ikuti langkah-langkah berikut:

  1. Di Visual Studio, pilih File>Baru>Project/Solution.

  2. Di jendela Buat proyek baru , buka kotak pencarian dan masukkan wpf. Dalam daftar templat proyek yang dihasilkan, pilih templat WPF Application yang memiliki penanda C# dan Windows, lalu pilih Berikutnya.

  3. Di jendela Mengonfigurasi proyek baru Anda, Anda dapat memperbarui Nama Proyek dan Nama Solusi, lalu pilih Next.

  4. Di jendela Informasi tambahan, di bawah Framework, pilih .NET 10.0 (atau versi terbaru), lalu pilih Buat.

    Visual Studio membuat proyek, dan muncul di Solution Explorer.

Menambahkan paket Newtonsoft.Json NuGet

Untuk menginstal paket NuGet dalam panduan memulai cepat ini, Anda dapat menggunakan NuGet Package Manager atau Package Manager Console. Bergantung pada format proyek Anda, penginstalan paket NuGet merekam dependensi dalam file proyek Anda atau file packages.config. Untuk informasi selengkapnya, lihat alur kerja penggunaan paket .

Pengelola Paket NuGet

Untuk menggunakan NuGet Package Manager untuk menginstal paket Newtonsoft.Json di Visual Studio, ikuti langkah-langkah berikut:

  1. Pilih Project>Kelola Paket NuGet.

  2. Pada halaman NuGet Package Manager, di samping sumber Paket, pilih nuget.org.

  3. Buka tab Telusuri dan cari Newtonsoft.Json. Dalam daftar, pilih Newtonsoft.Json, lalu pilih Instal.

    Screenshot dari Package Manager NuGet. Paket Newtonsoft.Json dipilih. Panel detailnya menampilkan data paket dan memiliki tombol Instal.

  4. Jika Anda diminta untuk memverifikasi penginstalan, pilih Terapkan.

Konsol Package Manager

Atau, untuk menggunakan Package Manager Console di Visual Studio untuk menginstal paket />

  1. Di Visual Studio, pilih Tools>NuGet Package Manager>Package Manager Console.

  2. Di bagian atas jendela Package Manager Console, pastikan daftar proyek Default menunjukkan proyek tempat Anda ingin menginstal paket. Jika Anda memiliki satu proyek dalam solusi, proyek tersebut telah dipilih sebelumnya.

    Screenshot jendela Konsol Package Manager, yang berisi informasi tentang versi dan lisensi. Daftar Proyek default disorot.

  3. Pada prompt konsol, masukkan perintah Install-Package Newtonsoft.Json. Untuk informasi selengkapnya tentang perintah ini, lihat Install-Package.

    Jendela konsol ini menampilkan output untuk perintah. Kesalahan biasanya menunjukkan bahwa paket tidak kompatibel dengan kerangka kerja target proyek.

Menggunakan API Newtonsoft.Json di aplikasi

Setelah menginstal paket NuGet, Anda dapat membuat referensi ke dalam kode Anda dengan menggunakan using <namespace> pernyataan , di mana <namespace> adalah nama paket yang Anda gunakan. Setelah membuat referensi, Anda dapat memanggil paket melalui API-nya.

Dengan paket Newtonsoft.Json yang ada dalam proyek, Anda dapat memanggil metodenya JsonConvert.SerializeObject. Untuk menggunakan metode ini untuk mengonversi objek ke string yang dapat dibaca manusia, lakukan langkah-langkah berikut:

  1. Di Solution Explorer, buka MainWindow.xaml dan ganti elemen />

    <Grid Background="White">
        <StackPanel VerticalAlignment="Center">
            <Button Click="Button_Click" Width="100px" HorizontalAlignment="Center" Content="Click Me" Margin="10"/>
            <TextBlock Name="TextBlock" HorizontalAlignment="Center" Text="TextBlock" Margin="10"/>
        </StackPanel>
    </Grid>
    
  2. Di Solution Explorer, perluas simpul MainWindow.xaml, lalu buka file MainWindow.xaml.cs. Sisipkan kode berikut ke dalam kelas MainWindow, setelah konstruktor.

    public class Account
    {
        public string ID { get; set; }
        public decimal Balance { get; set; }
        public DateTime Created { get; set; }
    }
    
    private void Button_Click(object sender, RoutedEventArgs e)
    {
        Account account = new Account
        {
            ID = "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
            Balance = 4389.21m,
            Created = new DateTime(2026, 4, 16, 0, 0, 0, DateTimeKind.Utc),
        };
        string json = JsonConvert.SerializeObject(account, Newtonsoft.Json.Formatting.Indented);
        TextBlock.Text = json;
    }
    
  3. Jika MainWindow.xaml.cs tidak berisi baris berikut, tambahkan ke awal file:

    using Newtonsoft.Json;
    

    Tanpa baris ini, Visual Studio menandai objek JsonConvert dengan garis merah dan berlekuk untuk menunjukkan kesalahan.

  4. Untuk membuat dan menjalankan aplikasi, pilih F5, atau pilih Debug>Mulai Penelusuran Kesalahan.

    Jendela berikut muncul:

    Screenshot jendela MainWindow yang dibuat aplikasi di Visual Studio. Jendela berisi tombol Klik Saya dan istilah TextBlock.

  5. Pilih Klik Saya. Aplikasi memperbarui jendela dengan mengganti TextBlock objek dengan teks JSON.

    Screenshot jendela MainWindow di Visual Studio, yang berisi tombol Klik Saya dan kode JSON yang mencantumkan ID, Balance, dan Create values.

Untuk video tentang menggunakan NuGet untuk manajemen paket, lihat Manajemen Paket .NET dengan NuGet untuk Pemula dan NuGet untuk Pemula.

Untuk mengetahui selengkapnya tentang menginstal dan mengelola paket NuGet, lihat artikel berikut ini:

Untuk informasi selengkapnya tentang NuGet, lihat artikel berikut ini: