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

Bu hızlı başlangıçta, Microsoft Visual Studio kullanarak bir projede NuGet paketi yükler ve kullanırsınız. NuGet paketi, diğer geliştiricilerin projelerinizde kullanımınıza sunabilecekleri yeniden kullanılabilir kodlar içerir.

NuGet Paket Yöneticisi, Paket Yöneticisi Console veya .NET komut satırı arabirimini (CLI) kullanarak bir NuGet paketini Visual Studio projesine yükleyebilirsiniz. Bu hızlı başlangıçta NuGet Paket Yöneticisi ve Paket Yöneticisi Konsolu'nu kullanarak paket yükleme işlemi gösterilmektedir. Popüler Newtonsoft.Json paketini kullanan bir Windows Presentation Foundation (WPF) projesi oluşturma adımlarını izleyin. Aynı işlem diğer tüm .NET projelerde de geçerlidir.

Bu makale yalnızca Windows kullanıcılar içindir. Mac için Visual Studio kullanıyorsanız bkz. Mac için Visual Studio'da paket yükleme ve kullanma.

Tip

NuGet paketi bulmak için nuget.org ile başlayın. Nuget.org'da gezinmek, .NET geliştiricilerin genellikle kendi uygulamalarında yeniden kullanabilecekleri bileşenleri bulmanın bir yoludur. Bu makalede gösterildiği gibi doğrudan nuget.org araması yapabilir veya Visual Studio içinde paketleri bulup yükleyebilirsiniz. Daha fazla bilgi için bkz. Projeniz için NuGet paketlerini bulma ve değerlendirme.

Önkoşullar

• .NET masaüstü geliştirme iş yüküyle Visual Studio 2026'yi yükleyin.

  2026 Community sürümünü visualstudio.microsoft.com ücretsiz olarak 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. Bu hızlı başlangıç için bir WPF Uygulaması projesi oluşturacaksınız.

Aşağıdaki adımları izleyin:

1. Visual Studio File>New>Project/Solution öğesini seçin.

2. Yeni proje oluştur penceresinde, arama kutusuna gidin ve wpf girin. Sonuçta elde edilen proje şablonları listesinde, C# ve Windows etiketlerine sahip WPF Application şablonunu ve ardından İleri seçin.

3. Yeni project penceresinde isteğe bağlı olarak Project name ve Solution name değerlerini güncelleştirin ve sonra Next'i seçin.

4. Ek bilgiler penceresinde, Framework altında .NET 10.0 (veya en son sürüm) seçeneğini belirleyin ve ardından Create öğesini seçin.

   Visual Studio projeyi oluşturur ve Çözüm Gezgini içinde görünür.

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, proje dosyanızdaki veya packages.config dosyanızdaki bağımlılığı kaydeder. Daha fazla bilgi için bkz. Paket tüketimi iş akışı.

NuGet Paket Yöneticisi

NuGet Paket Yöneticisi kullanarak Newtonsoft.Json paketini Visual Studio yüklemek için şu adımları izleyin:

1. Project> NuGet Paketlerini Yönet'yi seçin.

2. NuGet Paket Yöneticisi sayfasında, Package source yanındaki nuget.org öğesini seçin.

3. Gözat sekmesine gidin ve Newtonsoft.Json dosyasını arayın. Listede Newtonsoft.Json'u ve ardından Yükle'yi seçin.

   NuGet Paket Yöneticisi ekran görüntüsü. Newtonsoft.Json paketi seçilidir. Ayrıntılar bölmesinde paket verileri görüntülenir ve Yükle düğmesi bulunur.

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

Paket Yöneticisi Konsolu

Alternatif olarak, paketini yüklemek üzere Visual Studio Newtonsoft.Json kullanmak için şu adımları izleyin:

1. Visual Studio Tools>NuGet Paket Yöneticisi>Paket Yöneticisi Console öğesini seçin.

2. Paket Yöneticisi Konsolu penceresinin üst kısmında, Default projesi listesinin paketi yüklemek istediğiniz projeyi gösterdiğini doğrulayın. Çözümde tek bir projeniz varsa önceden seçilmiştir.

   

3. Konsol isteminde Install-Package Newtonsoft.Json komutunu girin. 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

NuGet paketini yükledikten sonra, deyimini kullanarak using <namespace> kodunuzda bu pakete başvuruda bulunabilirsiniz; burada <ad alanı> kullanmakta olduğunuz paketin adıdır. Sonrasinda bir referans yaptıktan sonra, API’sini kullanarak paketi çağırabilirsiniz.

Projede Newtonsoft.Json paketiyle, JsonConvert.SerializeObject yöntemini çağırabilirsiniz. Bir nesneyi okunabilir bir dizeye dönüştürmek için bu yöntemi kullanmak için şu adımları izleyin:

1. Çözüm Gezgini'da MainWindow.xaml açın ve var olan <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. Çözüm Gezgini'da MainWindow.xaml düğümünü genişletin ve MainWindow.xaml.cs dosyasını açın. Oluşturucudan sonra sınıfına MainWindow aşağıdaki kodu ekleyin:

   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. MainWindow.xaml.cs aşağıdaki satırı içermiyorsa, dosyanın başına ekleyin:

   using Newtonsoft.Json;
   

   Bu satır olmadan, Visual Studio JsonConvert nesnesini hata belirtmek için kırmızı, dalgalı bir çizgiyle işaretler.

4. Uygulamayı derlemek ve çalıştırmak için F5'i veya Hata Ayıklama>Hata Ayıklamayı Başlat seçin.

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

   

5. Bana Tıklayın. Uygulama, nesnesini JSON metniyle değiştirerek TextBlock pencereyi güncelleştirir.

   Screenshot of Visual Studio'daki MainWindow penceresi, içinde Beni Tıkla düğmesi ve ID, Bakiyen, Created değerlerini listeleyen JSON kodu bulundurur.

İlgili videolar

Paket yönetimi için NuGet kullanma hakkında videolar için bkz. Yeni Başlayanlar için NuGet ile .NET Paket Yönetimi ve yeni başlayanlar için NuGet.

İlgili içerik

NuGet paketlerini yükleme ve yönetme hakkında daha fazla bilgi edinmek için aşağıdaki makalelere bakın:

• NuGet Paket Yöneticisi'ni kullanarak Visual Studio'da paketleri yükleyin ve yönetin
• Visual Studio Paket Yöneticisi Konsolu (PowerShell)

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

• NuGet'e giriş
• Paket tüketimi iş akışı
• Projeniz için NuGet paketlerini bulma ve değerlendirme
• PackageReference proje dosyalarında
• dotnet CLI ile paket yükleme ve kullanma
• Newtonsoft.Json paketi