Bagikan melalui

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

Paket NuGet berisi kode yang dapat digunakan kembali yang telah disediakan pengembang lain untuk Anda gunakan dalam proyek Anda. Anda dapat menginstal paket NuGet di 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 Newtonsoft.Json populer. 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 pernyataan using <namespace>, 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.

Saran

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 panduan cepat ini, Anda akan membuat proyek Aplikasi Windows Presentation Foundation (WPF).

Ikuti langkah-langkah berikut:

  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 , lalu pilih Berikutnya.

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

    Visual Studio membuat proyek, dan muncul di Solution Explorer.

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 penggunaan paket .

Pengelola Paket NuGet

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

  1. Pilih Project>Kelola Paket NuGet.

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

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

    Cuplikan layar memperlihatkan jendela Manajer Paket NuGet dengan paket Newtonsoft.Json dipilih.

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

Konsol Manajer Paket

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

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

  2. Setelah panel Package Manager Console 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.

    Cuplikan layar memperlihatkan jendela Konsol Manajemen Paket dengan 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

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

  1. Dari Solution Explorer, buka MainWindow.xaml dan ganti elemen <Grid> yang ada 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 sisipkan kode berikut di dalam kelas MainWindow 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 objek JsonConvert 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 muncul:

    Cuplikan layar memperlihatkan output awal aplikasi WPF.

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

    Cuplikan layar memperlihatkan output aplikasi WPF setelah memilih tombol .

  • Temukan video NuGet di Channel 9 dan YouTube.

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 Pengelola Paket NuGet

Menginstal dan mengelola paket menggunakan Package Manager Console

  • Last updated on