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

  • Artikel

Paket NuGet berisi kode yang dapat digunakan kembali yang telah disediakan pengembang lain untuk Anda gunakan dalam proyek Anda. Anda dapat menginstal paket NuGet dalam proyek Microsoft Visual Studio dengan menggunakan NuGet Package Manager, Package Manager Console, atau .NET CLI. Artikel ini menunjukkan cara membuat proyek Windows Presentation Foundation (WPF) dengan paket populer Newtonsoft.Json . Proses yang sama berlaku untuk proyek .NET atau .NET Core lainnya.

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

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

Tip

Untuk menemukan paket NuGet, mulailah dengan nuget.org. Menelusuri nuget.org adalah bagaimana pengembang .NET biasanya menemukan komponen yang dapat mereka gunakan kembali dalam 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.

Prasyarat

  • Instal Visual Studio 2022 untuk Windows dengan beban kerja pengembangan desktop .NET.

    Anda dapat menginstal edisi Komunitas 2022 secara gratis dari visualstudio.microsoft.com, atau 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. Namun, untuk mulai cepat ini Anda akan membuat proyek Aplikasi Windows Presentation Foundation (WPF).

Ikuti langkah-langkah ini:

  1. Di Visual Studio, pilih File>Baru>Proyek.

  2. Di jendela Buat proyek baru, masukkan WPF di kotak pencarian dan pilih C# dan Windows di daftar dropdown. Dalam daftar templat proyek yang dihasilkan, pilih Aplikasi WPF, lalu pilih Berikutnya.

  3. Di jendela Konfigurasikan proyek baru Anda, perbarui nama Proyek dan nama Solusi secara opsional, lalu pilih Berikutnya.

  4. Di jendela Informasi tambahan, pilih .NET 6.0 (atau versi terbaru) untuk Kerangka Kerja, lalu pilih Buat.

    Visual Studio membuat proyek, dan muncul di Penjelajah Solusi.

Menambahkan paket Newtonsoft.Json NuGet

Untuk menginstal paket NuGet dalam mulai cepat ini, Anda dapat menggunakan Manajer Paket NuGet atau Konsol Manajer Paket. Bergantung pada format proyek Anda, penginstalan paket NuGet merekam dependensi dalam file proyek Anda atau file packages.config . Untuk informasi selengkapnya, lihat Alur kerja konsumsi paket.

Manajer Paket NuGet

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

  1. Pilih Project>Manage NuGet Packages.

  2. Di halaman Manajer Paket NuGet, pilih nuget.org sebagai sumber Paket.

  3. Dari tab Telusuri , cari Newtonsoft.Json, pilih Newtonsoft.Json dalam daftar, lalu pilih Instal.

    Screenshot showing the NuGet Package Manager window with the Newtonsoft.Json package selected.

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

Konsol Manajer Paket

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

  1. Dari Visual Studio, pilih Alat>NuGet Package Manager>Package Manager Console.

  2. Setelah panel Konsol Manajer Paket terbuka, verifikasi bahwa daftar drop-down Proyek default menampilkan proyek tempat Anda ingin menginstal paket. Jika Anda memiliki satu proyek dalam solusi, proyek tersebut telah dipilih sebelumnya.

    Screenshot showing the Package Manage Console window with Default project highlighted.

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

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

Menggunakan API Newtonsoft.Json di aplikasi

Newtonsoft.Json Dengan paket dalam proyek, panggil metodenya JsonConvert.SerializeObject untuk mengonversi objek ke string yang dapat dibaca manusia:

  1. Dari Penjelajah Solusi, buka MainWindow.xaml dan ganti elemen yang ada <Grid>dengan kode berikut:

    <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. Buka file MainWindow.xaml.cs di bawah simpul MainWindow.xaml, dan masukkan kode berikut di MainWindow dalam kelas setelah konstruktor:

    public class Account
{
    public string Name { get; set; }
    public string Email { get; set; }
    public DateTime DOB { get; set; }
}

private void Button_Click(object sender, RoutedEventArgs e)
{
    Account account = new Account
    {
        Name = "John Doe",
        Email = "john@microsoft.com",
        DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
    };
    string json = JsonConvert.SerializeObject(account, Newtonsoft.Json.Formatting.Indented);
    TextBlock.Text = json;
}

  3. Untuk menghindari kesalahan untuk JsonConvert objek dalam kode (baris berlekuk merah akan muncul), tambahkan pernyataan berikut di awal file kode:

    using Newtonsoft.Json;

  4. Untuk membuat dan menjalankan aplikasi, tekan F5 atau pilih Debug>Mulai Debugging.

    Jendela berikut akan muncul:

    Screenshot showing the initial output of the WPF app.

  5. Pilih tombol Klik Saya untuk melihat konten TextBlock objek yang diganti dengan teks JSON.

    Screenshot showing the output of the WPF app after selecting the button.

Lihat juga

Untuk informasi selengkapnya tentang NuGet, lihat artikel berikut ini:

Langkah berikutnya

Selamat atas penginstalan dan penggunaan paket NuGet pertama Anda. Lanjutkan ke artikel berikutnya untuk mempelajari selengkapnya tentang menginstal dan mengelola paket NuGet.

Menginstal dan mengelola paket menggunakan NuGet Package Manager

Menginstal dan mengelola paket menggunakan Package Manager Console