Hızlı Başlangıç: dotnet CLI ile paket yükleme ve kullanma

  • Makale

NuGet paketleri, geliştiricilerin diğer geliştiricilerin projelerinde kullanabilmesi için kullanıma sunabilecekleri derlenmiş ikili kod içerir. Daha fazla bilgi için bkz . NuGet nedir? Bu hızlı başlangıçta, dotnet add package komutunu kullanarak popüler Newtonsoft.Json NuGet paketinin bir .NET projesine nasıl yükleneceği açıklanmaktadır.

Kodda yüklü paketlere genellikle paket adı olan <namespace> bir using <namespace> yönergeyle başvurursunuz. Ardından paketin API'sini projenizde kullanabilirsiniz.

İpucu

Kendi uygulamalarınızda yeniden kullanabileceğiniz paketleri bulmak için nuget.org/packages göz atın. Doğrudan adresinde https://nuget.orgarama yapabilir veya Visual Studio'dan paketleri bulup yükleyebilirsiniz. Daha fazla bilgi için bkz . Projeniz için NuGet paketlerini bulma ve değerlendirme.

Önkoşullar

Bir proje oluştur

NuGet paketlerini bir .NET projesine yükleyebilirsiniz. Bu izlenecek yol için dotnet CLI'sini kullanarak aşağıdaki gibi basit bir .NET konsol projesi oluşturun:

  1. Proje için Nuget.Quickstart adlı bir klasör oluşturun.

  2. Bir komut istemi açın ve yeni klasöre geçin.

  3. Aşağıdaki komutu kullanarak projeyi oluşturun:

    dotnet new console

  4. Uygulamayı test etmek için kullanın dotnet run . çıktısını Hello, World!görmeniz gerekir.

Newtonsoft.Json NuGet paketini ekleme

  1. Paketi yüklemek Newtonsoft.json için aşağıdaki komutu kullanın:

    dotnet add package Newtonsoft.Json

  2. Komut tamamlandıktan sonra, eklenen NuGet paket başvurusunu görmek için Visual Studio'da Nuget.Quickstart.csproj dosyasını açın:

    <ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
</ItemGroup>

Uygulamada Newtonsoft.Json API'sini kullanma

  1. Visual Studio'da Program.cs dosyasını açın ve dosyanın en üstüne aşağıdaki satırı ekleyin:

    using Newtonsoft.Json;

  2. deyimini değiştirmek Console.WriteLine("Hello, World!"); için aşağıdaki kodu ekleyin:

    namespace Nuget.Quickstart
{
    public class Account
    {
        public string? Name { get; set; }
        public string? Email { get; set; }
        public DateTime DOB { get; set; }
    }
    internal class Program
    {
        static void Main(string[] args)
        {
            Account account = new Account
            {
                Name = "John Doe",
                Email = "john@nuget.org",
                DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
            };

            string json = JsonConvert.SerializeObject(account, Formatting.Indented);
            Console.WriteLine(json);
        }
    }
}

  3. Dosyayı kaydedin, ardından komutunu kullanarak dotnet run uygulamayı derleyin ve çalıştırın. Çıkış, koddaki nesnenin Account JSON gösterimidir:

    {
  "Name": "John Doe",
  "Email": "john@nuget.org",
  "DOB": "1980-02-20T00:00:00Z"
}

İlk NuGet paketinizi yüklediğiniz ve kullandığınız için tebrikler!

Channel 9 ve YouTube'da daha fazla NuGet videosu bulun.

Sonraki adımlar

Dotnet CLI ile NuGet paketlerini yükleme ve kullanma hakkında daha fazla bilgi edinin:

dotnet CLI kullanarak paketleri yükleme ve kullanma