Mengimpor dari manajer paket

  • 3 menit

Pustaka Microsoft.Azure.Cosmos, termasuk semua versi sebelumnya, dihosting di nuget untuk mempermudah impor pustaka ke aplikasi .NET.

Mengimpor paket NuGet

Untuk mengimpor paket NuGet ke dalam aplikasi .NET, Anda harus menggunakan .NET CLI. CLI menyertakan perintah dotnet add yang digunakan untuk menambahkan sumber daya ke proyek .NET. Untuk menambahkan paket NuGet secara khusus, Anda harus melakukan salah satu hal berikut:

Mengimpor versi terbaru dari paket

Memanggil perintah dotnet add package hanya dengan nama paket. Misalnya, perintah ini akan mengimpor versi stabil terbaru dari pustaka Microsoft.Azure.Cosmos.

dotnet add package Microsoft.Azure.Cosmos

Tip

Perintah ini hanya akan mengimpor versi paket yang stabil. Jika pratinjau paket yang lebih baru tersedia, perintah akan mengimpor versi stabil yang lebih lama. Jika tidak ada versi stabil yang tersedia, perintah tidak akan mengimpor paket sama sekali.

Mengimpor versi paket tertentu

Panggil perintah dotnet add package dengan nama paket dan argumen --version yang menentukan versi paket tertentu. Misalnya, perintah ini akan mengimpor versi 3.22.1 dari pustaka Microsoft.Azure.Cosmos.

dotnet add package Microsoft.Azure.Cosmos \
    --version 3.22.1

Tip

Menentukan versi paket adalah satu-satunya cara untuk mengimpor versi pratinjau paket yang belum ditandai sebagai stabil.

File proyek .NET

Setelah diimpor, spesifikasi paket akan ditambahkan ke file csproj untuk proyek .NET. File proyek menggunakan format XML dan elemen baru bernama PackageReference dibuat dalam elemen ItemGroup dengan nama paket dan versinya. Dalam contoh ini, versi 3.22.1 pustaka Microsoft.Azure.Cosmos diimpor ke proyek dari NuGet.

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net6.0</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.Azure.Cosmos" Version="3.22.1" />
  </ItemGroup>
</Project>

Catatan

Versi paket akan ditambahkan apakah Anda menentukannya dalam perintah impor atau tidak. Jika Anda tidak menentukan versi paket, versi paket stabil terbaru yang diimpor ditentukan dalam file proyek.