hızlı başlangıç: Visual Studio bir paketi yükleyip kullanma (yalnızca Windows)

Makale
12/02/2021
Okumak için 3 dakika

NuGet paketler, diğer geliştiricilerin projelerinizde kullanabileceğiniz bir yeniden kullanılabilir kod içerir. arka plan için ne NuGet? ne olduğunu görün. paketler, NuGet Paket Yöneticisi, Paket Yöneticisi konsoluveya dotnet clıkullanarak bir Visual Studio projesine yüklenir. bu makalede, popüler newtonsoft. Json paketini ve bir Windows Presentation Foundation (WPF) projesini kullanan işlem gösterilmektedir. Aynı işlem, diğer tüm .NET veya .NET Core projeleri için de geçerlidir.

Yüklendikten sonra, koddaki pakete, using <namespace>< ad alanının > kullandığınız pakete özgü olduğunu bakın. Başvuru yapıldıktan sonra, paketini API 'SI aracılığıyla çağırabilirsiniz.

İpucu

NuGet.org Ile başlayın: gözatma NuGet.org , .NET geliştiricilerinin kendi uygulamalarında yeniden kullanabilecekleri bileşenleri genellikle nasıl buldukları. bu makalede gösterildiği gibi, nuget.org doğrudan arayabilir veya Visual Studio içindeki paketleri bulabilir ve yükleyebilirsiniz. genel bilgiler için bkz. NuGet paketlerini bulma ve değerlendirme.

Önkoşullar

.net masaüstü geliştirme iş yüküyle 2019 Visual Studio.

2019 Community sürümünü visualstudio.com adresinden ücretsiz olarak yükleyebilir veya Professional veya Enterprise sürümlerini kullanabilirsiniz.

Mac için Visual Studio kullanıyorsanız, bkz. Mac için Visual Studio bir paketi yükleyip kullanma.

Proje oluşturma

NuGet paketler, paketin proje ile aynı hedef framework 'ü desteklemesi kaydıyla herhangi bir .net projesine yüklenebilir.

Bu izlenecek yol için basit bir WPF uygulaması kullanın. yeni dosyaProject kullanarak Visual Studio bir proje oluşturun , arama kutusuna .net yazın ve ardından WPF uygulamasını (.NET Framework)seçin. İleri’ye tıklayın. İstendiğinde Framework için varsayılan değerleri kabul edin.

Visual Studio, Çözüm Gezgini açılan projeyi oluşturur.

newtonsoft. Json NuGet paketini ekleme

paketi yüklemek için NuGet Paket Yöneticisi ya da Paket Yöneticisi konsolunu kullanabilirsiniz. bir paket yüklediğinizde NuGet, bağımlılığı proje dosyanıza ya da bir packages.config dosyaya (proje biçimine bağlı olarak) kaydeder. Daha fazla bilgi için bkz. paket tüketimine genel bakış ve iş akışı.

NuGet Paket Yöneticisi

Çözüm Gezgini ' de, başvurular ' a sağ tıklayın ve NuGet paketlerini yönet' i seçin.
Paket kaynağıolarak "NuGet.org" öğesini seçin, Gözden geçirme sekmesini seçin, Newtonsoft. JSON' ı arayın, listeden bu paketi seçin ve sonra da yüklemeyiseçin:

NuGet Paket Yöneticisi hakkında daha fazla bilgi istiyorsanız bkz. Visual Studio kullanarak paket yükleyip yönetme.
Tüm lisans istemlerini kabul edin.
(yalnızca Visual Studio 2017) bir paket yönetimi biçimi seçmeniz istenirse, proje dosyasında packagereferenceöğesini seçin:
Değişiklikleri gözden geçirmeniz istenirse Tamam' ı seçin.

Paket Yöneticisi Konsolu

araçlarNuGet Paket YöneticisiPaket Yöneticisi konsol menü komutunu seçin.
Konsol açıldıktan sonra, varsayılan proje açılan listesinin paketi yüklemek istediğiniz projeyi gösterdiğini kontrol edin. Çözümde tek bir projeniz varsa, zaten seçilidir.
Komutu girin Install-Package Newtonsoft.Json (bkz. Install-Package Newtonsoft.Json). Konsol penceresinde komutun çıktısı gösterilir. Hatalar genellikle paketin projenin hedef çerçevesiyle uyumlu olmadığını gösterir.

Paket Yöneticisi konsolu hakkında daha fazla bilgi edinmek istiyorsanız, bkz. Paket Yöneticisi konsolunu kullanarak paketleri yükleyip yönetme.

Uygulamada Newtonsoft. JSON API 'sini kullanma

Projedeki Newtonsoft. JSON paketiyle, JsonConvert.SerializeObject bir nesneyi insan tarafından okunabilen bir dizeye dönüştürmek için yöntemini çağırabilirsiniz.

MainWindow.xamlÖğesini açın ve var olan Grid öğeyi şu şekilde 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>

Dosyasını açın MainWindow.xaml.cs (düğüm altında Çözüm Gezgini bulunur MainWindow.xaml ) ve aşağıdaki kodu MainWindow sınıfına 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, Formatting.Indented);
    TextBlock.Text = json;
}

Newtonsoft. JSON paketini projeye ekleseniz de, JsonConvertusing kod dosyasının en üstünde bir deyime ihtiyacınız olduğu için kırmızı dalgalı çizgiler altında görünür:
```
using Newtonsoft.Json;
```
F5 tuşuna basarak veya hata ayıklamabaşlatma hata ayıklamayıseçerek uygulamayı derleyin ve çalıştırın:
Bir JSON metniyle değiştirilmiş olan TextBlock içeriğini görmek için düğmeyi seçin: