Latihan - Membuat aplikasi .NET serta referensi SDK

  • 7 menit

Sebagai langkah pertama dalam membuat aplikasi proyek, Anda perlu membuat proyek .NET. Ingat bahwa proyek .NET harus menggunakan Microsoft.Azure.Cosmos SDK untuk menyambungkan ke akun yang sudah Anda buat. Ada tiga persyaratan utama saat ini:

  • Membuat proyek .NET
  • Menambahkan referensi paket ke SDK
  • Menghubungkan menggunakan kelas klien

Illustration of icons of an Azure Cosmos DB account and .NET application.

Setelah menyelesaikan latihan ini, Anda akan memiliki aplikasi .NET sederhana yang berhasil terhubung ke API Anda untuk akun NoSQL, tetapi belum melakukan operasi apa pun.

Membuat proyek konsol .NET

.NET CLI membuat dan mengelola proyek .NET di dalam direktori tertentu. Di sini, Anda menggunakan CLI untuk membuat aplikasi konsol baru dan menambahkan referensi paket ke SDK.

  1. Buat aplikasi konsol baru di direktori saat ini.

    dotnet new console

    Tip

    Karena Anda tidak menentukan nama proyek atau direktori, perintah ini akan membuat proyek baru di direktori saat ini dan memberi nama proyek agar sesuai dengan nama direktori (inventaris).

  2. Tambahkan referensi paket ke versi 3 dari Microsoft.Azure.Cosmos SDK dari NuGet.

    dotnet add package Microsoft.Azure.Cosmos --version 3.*

  3. Buat proyek .NET untuk memastikan Anda mengonfigurasi proyek dengan benar.

    dotnet build

    Output perintah harus mirip dengan contoh ini:

    MSBuild version 17.5.0+6f08c67f3 for .NET
  Determining projects to restore...
  All projects are up-to-date for restore.
  dotnet-env-azure-cosmos-db -> /workspaces/dotnet-env-azure-cosmos-db/bin/Debug/net7.0/dotnet-env-azure-cosmos-db.dll

Build succeeded.
    0 Warning(s)
    0 Error(s)

Time Elapsed 00:00:05.96

Sambungkan ke akun

Sekarang, proyek .NET sudah dibangun dan siap untuk ditambahkan kode kustom Anda sendiri. Anda memiliki akses ke Microsoft.Azure.Cosmos namespace layanan dan semua kelas yang diperlukan untuk terhubung ke API untuk NoSQL. Di sini, Anda membuka file Program.cs dan menerapkan kode untuk menyambungkan ke akun menggunakan kelas klien SDK.

  1. Buka file Program.cs di dalam editor kode.

  2. Hapus semua kode yang ada dari file.

  3. Tambahkan menggunakan direktif untuk namespace berikut:

    using Microsoft.Azure.Cosmos;
using Microsoft.Azure.Cosmos.Fluent;
using Microsoft.Azure.Cosmos.Linq;

  4. Buat variabel string konstanta bernama connectionString. Atur nilai variabel ke string koneksi yang Anda rekam sebelumnya dalam modul ini.

    const string connectionString = "<your-azure-cosmos-db-connection-string>";

    Tip

    Dengan asumsi nama akun Azure Cosmos DB adalah dan kuncinya adalah nybncrsna76fo-cosmos-nosqlAj2OSQqWhXfFzkITIi4MIbocWAAoBCUWnSPzHlQbDYA3TiyZCJlk8A6R1l6WqD45BxAG5vrsyQ4SCXEkPS1pLh==, Anda akan mengonfigurasi string koneksi seperti contoh ini:

    const string connectionString = "AccountEndpoint=https://nybncrsna76fo-cosmos-nosql.documents.azure.com:443/;AccountKey=Aj2OSQqWhXfFzkITIi4MIbocWAAoBCUWnSPzHlQbDYA3TiyZCJlk8A6R1l6WqD45BxAG5vrsyQ4SCXEkPS1pLh==;";

  5. Cetak string koneksi ke konsol.

    Console.WriteLine($"[Connection string]:\t{connectionString}");

  6. Buat instans baru untuk kelas CosmosSerializationOptions bernama serializerOptions. Atur properti PropertyNamingPolicy ke nilai CamelCase dari enumerasi CamelCase.

    CosmosSerializationOptions serializerOptions = new()
{
    PropertyNamingPolicy = CosmosPropertyNamingPolicy.CamelCase
};

  7. Buat instans baru kelas CosmosClientBuilder dengan meneruskan string koneksi ke konstruktor. Selanjutnya, rantai metode fasih WithSerializerOptions(CosmosSerializationOptions) dan atur parameter metode ini ke serializerOptions. Build() Rantai metode untuk membuat instans jenis CosmosClient bernama client. Terakhir, bungkus pembuatan variabel klien dengan pernyataan penggunaan.

    using CosmosClient client = new CosmosClientBuilder(connectionString)
    .WithSerializerOptions(serializerOptions)
    .Build();

  8. Cetak pesan yang menunjukkan klien Anda sudah siap.

    Console.WriteLine("[Client ready]");

  9. Simpan file Program.cs.

Periksa pekerjaan Anda

Aplikasi ini sekarang siap untuk menjalankan dan menyambungkan ke Azure Cosmos DB untuk NoSQL. Di sini, Anda membandingkan kode aplikasi Anda dengan sampel kami. Kemudian, Anda memeriksa apakah aplikasi Anda berfungsi seperti yang diharapkan dengan menjalankan kode.

  1. Jalankan aplikasi .NET di terminal

    dotnet run

  2. Amati output dari menjalankan aplikasi. Output harus sesuai dengan contoh di sini.

    [Connection string]:    <your-azure-cosmos-db-connection-string>
[Client ready]

Catatan

Jika membuat atau menjalankan aplikasi .NET menghasilkan kesalahan, buka tab Tinjau kode untuk memvalidasi bahwa kode Anda cocok dengan contoh.