Mulai cepat: Membuat aplikasi .NET dengan App Configuration

Dalam mulai cepat ini, Anda menggabungkan Azure App Configuration ke dalam aplikasi konsol .NET untuk memusatkan penyimpanan dan manajemen pengaturan aplikasi yang terpisah dari kode Anda.

Prasyarat

Menambahkan nilai kunci

Tambahkan nilai kunci berikut ke penyimpanan App Configuration dan biarkan Label dan Tipe Konten dengan nilai defaultnya. Untuk informasi selengkapnya tentang cara menambahkan nilai kunci ke penyimpanan menggunakan portal Azure atau CLI, buka Membuat nilai kunci.

Tombol Nilai
TestApp:Pengaturan:Message Data dari Azure App Configuration

Membuat aplikasi konsol NET

Anda dapat menggunakan antarmuka baris perintah .NET (CLI) untuk membuat proyek aplikasi konsol .NET baru. Keuntungan menggunakan .NET CLI melalui Visual Studio adalah tersedia di seluruh platform Windows, macOS, dan Linux. Atau, gunakan alat yang sudah terinstal sebelumnya yang tersedia di Azure Cloud Shell.

  1. Membuat folder baru untuk proyek Anda.

  2. Di folder baru, jalankan perintah berikut untuk membuat proyek aplikasi konsol .NET baru:

    dotnet new console
    

Tersambung ke Penyimpanan App Configuration

  1. Tambahkan referensi ke paket NuGet Microsoft.Extensions.Configuration.AzureAppConfiguration dengan menjalankan perintah berikut:

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    
  2. Jalankan perintah berikut untuk memulihkan paket untuk proyek Anda:

    dotnet restore
    
  3. Buka Program.cs, dan tambahkan pernyataan berikut:

    using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
    
  4. Gunakan App Configuration dengan memanggil AddAzureAppConfiguration metode dalam Program.cs file.

    var builder = new ConfigurationBuilder();
    builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));
    
    var config = builder.Build();
    Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");
    

Membangun dan menjalankan aplikasi secara lokal

  1. Set variabel lingkungan bernama ConnectionString, dan set ke kunci akses ke simpan Azure App Configuration Anda. Pada baris perintah, jalankan perintah berikut ini:

    Untuk membuat dan menjalankan aplikasi secara lokal menggunakan perintah Windows, jalankan perintah berikut:

    setx ConnectionString "connection-string-of-your-app-configuration-store"
    

    Hidupkan ulang perintah untuk mengizinkan perubahan. Cetak nilai variabel lingkungan untuk memvalidasi bahwa variabel tersebut diatur dengan benar.

  2. Jalankan perintah berikut untuk membuat aplikasi konsol:

    dotnet build
    
  3. Setelah pembangunan berhasil diselesaikan, jalankan perintah berikut untuk menjalankan aplikasi secara lokal:

    dotnet run
    

Membersihkan sumber daya

Jika Anda tidak ingin terus menggunakan sumber daya yang dibuat dalam artikel ini, hapus grup sumber daya yang Anda buat di sini untuk menghindari biaya.

Penting

Penghapusan grup sumber daya tidak bisa dipulihkan. Grup sumber daya dan semua sumber daya yang ada di dalamnya akan dihapus secara permanen. Pastikan Anda tidak menghapus grup atau sumber daya yang salah secara tidak sengaja. Jika Anda membuat sumber daya untuk artikel ini dalam grup sumber daya yang ada yang berisi sumber daya lain yang ingin disimpan, hapus setiap sumber daya satu per satu dari panelnya masing-masing, bukan menghapus grup sumber daya.

  1. Masuk ke portal Azure, lalu pilih Grup sumber daya.
  2. Dalam kotak Filter menurut nama, masukkan nama grup sumber daya Anda.
  3. Dalam daftar hasil, pilih nama grup sumber daya untuk melihat gambaran umum.
  4. Pilih Hapus grup sumber daya.
  5. Anda akan diminta untuk mengonfirmasi penghapusan grup sumber daya. Masukkan nama grup sumber daya Anda untuk mengonfirmasi, dan pilih Hapus.

Setelah beberapa saat, grup sumber daya dan semua sumber dayanya akan dihapus.

Langkah berikutnya

Dalam mulai cepat ini, Anda membuat penyimpanan App Configuration baru dan menggunakannya dengan aplikasi konsol .NET melalui penyedia App Configuration. Untuk mempelajari cara mengonfigurasi aplikasi .NET Anda untuk menyegarkan pengaturan konfigurasi secara dinamis, lanjutkan ke tutorial berikutnya.