Hızlı Başlangıç: Visual Studio'da NuGet paketi yükleme ve kullanma (yalnızca Windows)

  • Makale

NuGet paketi, diğer geliştiricilerin projelerinizde kullanımınıza sunduğunu yeniden kullanılabilir kod içerir. NuGet Paket Yöneticisi, Paket Yöneticisi Konsolu veya .NET CLI kullanarak Bir Microsoft Visual Studio projesine NuGet paketi yükleyebilirsiniz. Bu makalede, popüler Newtonsoft.Json paketle bir Windows Presentation Foundation (WPF) projesinin nasıl oluşturulacağı gösterilmektedir. Aynı işlem diğer tüm .NET veya .NET Core projeleri için de geçerlidir.

NuGet paketini yükledikten sonra kodunuzda using <namespace> bu pakete başvuruda bulunabilirsiniz. Burada <ad alanı> kullanmakta olduğunuz paketin adıdır. Bir başvuru yaptıktan sonra api'sini kullanarak paketi çağırabilirsiniz.

Makale yalnızca Windows kullanıcılarına yöneliktir. Mac için Visual Studio kullanıyorsanız bkz. Mac için Visual Studio'da paket yükleme ve kullanma.

İpucu

NuGet paketi bulmak için nuget.org ile başlayın. Gözatma nuget.org, .NET geliştiricilerinin genellikle kendi uygulamalarında yeniden kullanabilecekleri bileşenleri bulma şeklidir. Doğrudan nuget.org araması yapabilir veya bu makalede gösterildiği gibi Visual Studio'da paketleri bulup yükleyebilirsiniz. Daha fazla bilgi için bkz . NuGet paketlerini bulma ve değerlendirme.

Önkoşullar

  • .NET masaüstü geliştirme iş yüküyle Windows için Visual Studio 2022'yi yükleyin.

    2022 Community sürümünü visualstudio.microsoft.com ücretsiz yükleyebilir veya Professional veya Enterprise sürümünü kullanabilirsiniz.

Bir proje oluştur

Bu paket projeyle aynı hedef çerçeveyi destekliyorsa herhangi bir .NET projesine NuGet paketi yükleyebilirsiniz. Ancak, bu hızlı başlangıç için bir Windows Presentation Foundation (WPF) Uygulaması projesi oluşturacaksınız.

Şu adımları izleyin:

  1. Visual Studio'da Dosya>Yeni Proje'yi> seçin.

  2. Yeni proje oluştur penceresinde, arama kutusuna WPF yazın ve açılan listelerde C# ve Windows'u seçin. Sonuçta elde edilen proje şablonları listesinde WPF Uygulaması'nı ve ardından İleri'yi seçin.

  3. Yeni projenizi yapılandırın penceresinde, isteğe bağlı olarak Proje adını ve Çözüm adını güncelleştirin ve İleri'yi seçin.

  4. Ek bilgiler penceresinde, Framework için .NET 6.0 (veya en son sürüm) öğesini ve ardından Oluştur'u seçin.

    Visual Studio projeyi oluşturur ve Çözüm Gezgini görüntülenir.

Newtonsoft.Json NuGet paketini ekleme

Bu hızlı başlangıçta bir NuGet paketi yüklemek için NuGet Paket Yöneticisi veya Paket Yöneticisi Konsolu'nu kullanabilirsiniz. Proje biçiminize bağlı olarak, NuGet paketinin yüklenmesi, bağımlılığı proje dosyanıza veya packages.config dosyasına kaydeder. Daha fazla bilgi için bkz . Paket tüketimi iş akışı.

NuGet Paket Yöneticisi

Visual Studio'da paketi yüklemek Newtonsoft.Json üzere NuGet Paket Yöneticisi kullanmak için şu adımları izleyin:

  1. NuGet Paketlerini Proje>Yönet'i seçin.

  2. NuGet Paket Yöneticisi sayfasında Paket kaynağı olarak nuget.org seçin.

  3. Gözat sekmesinde Newtonsoft.Json için arama yapın, listeden Newtonsoft.Json'u seçin ve ardından Yükle'yi seçin.

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

  4. Yüklemeyi doğrulamanız istenirse Tamam'ı seçin.

Paket Yöneticisi Konsolu

Alternatif olarak, paketi yüklemek için Visual Studio'daki Paket Yöneticisi Konsolu'nuNewtonsoft.Json kullanmak için şu adımları izleyin:

  1. Visual Studio'da Araçlar>NuGet Paket Yöneticisi> Paket Yöneticisi Konsolu'nu seçin.

  2. Paket Yöneticisi Konsolu bölmesi açıldıktan sonra, Varsayılan proje açılan listesinde paketi yüklemek istediğiniz projenin gösterildiğini doğrulayın. Çözümde tek bir projeniz varsa önceden seçilmiştir.

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

  3. Konsol isteminde komutunu Install-Package Newtonsoft.Jsongirin. Bu komut hakkında daha fazla bilgi için bkz . Install-Package.

    Konsol penceresinde komutun çıktısı gösterilir. Hatalar genellikle paketin projenin hedef çerçevesiyle uyumlu olmadığını gösterir.

Uygulamada Newtonsoft.Json API'sini kullanma

Newtonsoft.Json Projedeki paketiyle, nesnesini insan tarafından okunabilir bir dizeye dönüştürmek için yöntemini çağırınJsonConvert.SerializeObject:

  1. Çözüm Gezgini MainWindow.xaml dosyasını açın ve mevcut <Grid> öğesini aşağıdaki kodla değiştirin:

    <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. MainWindow.xaml düğümü altındaki MainWindow.xaml.cs dosyasını açın ve oluşturucudan sonra sınıfın MainWindow içine aşağıdaki kodu ekleyin:

    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. Koddaki nesnenin JsonConvert hatasını önlemek için (kırmızı dalgalı çizgi görünür), kod dosyasının başına aşağıdaki deyimi ekleyin:

    using Newtonsoft.Json;

  4. Uygulamayı derlemek ve çalıştırmak için F5 tuşuna basın veya Hata AyıklamaYı>Başlat Hata Ayıklama'yı seçin.

    Aşağıdaki pencere görüntülenir:

    Screenshot showing the initial output of the WPF app.

  5. Nesnenin içeriğini TextBlock JSON metniyle değiştirmek için Beni Tıklatın düğmesini seçin.

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

Ayrıca bkz.

NuGet hakkında daha fazla bilgi için aşağıdaki makalelere bakın:

Sonraki adımlar

İlk NuGet paketinizi yüklediğiniz ve kullandığınız için tebrikler. NuGet paketlerini yükleme ve yönetme hakkında daha fazla bilgi edinmek için sonraki makaleye geçin.

NuGet Paket Yöneticisi kullanarak paketleri yükleme ve yönetme

Paket Yöneticisi Konsolunu kullanarak paketleri yükleme ve yönetme