Mulai cepat: Membuat aplikasi .NET Framework dengan Azure App Configuration

Artikel
02/21/2024

Ada dua cara untuk memasukkan Azure App Configuration ke dalam aplikasi berbasis .NET Framework.

Penyusun konfigurasi untuk App Configuration memungkinkan data dari App Configuration dimuat ke Pengaturan Aplikasi. Aplikasi Anda mengakses konfigurasi seperti biasanya melalui ConfigurationManager. Anda tidak perlu membuat perubahan kode selain pembaruan untuk file app.config atau web.config. Mulai cepat ini akan memandu Anda melalui opsi ini.
Seperti yang dirancang oleh .NET Framework, Pengaturan Aplikasi hanya dapat disegarkan saat aplikasi dimulai ulang. Penyedia .NET App Configuration adalah pustaka Standar .NET. Ini mendukung konfigurasi penembolokan dan penyegaran secara dinamis tanpa memulai ulang aplikasi. Jika konfigurasi dinamis sangat penting bagi Anda dan Anda bersedia membuat perubahan kode, lihat tutorial tentang cara menerapkan pembaruan konfigurasi dinamis di aplikasi konsol .NET Framework atau aplikasi web ASP.NET.

Dalam mulai cepat ini, aplikasi konsol .NET Framework digunakan sebagai contoh, tetapi teknik yang sama berlaku untuk aplikasi Formulir Web ASP.NET/MVC.

Prasyarat

Akun Azure dengan langganan aktif. Buat akun gratis.
Penyimpanan App Configuration. Buat toko.
Visual Studio
.NET Framework 4.7.2 atau yang lebih baru

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 Framework

Mulai Visual Studio dan pilih Buat proyek baru.
Di Buat proyek baru, filter pada jenis proyek Konsol dan klik Aplikasi Konsol (.NET Framework) dengan C# dari daftar templae proyek. Tekan Berikutnya.
Di Konfigurasikan proyek baru Anda, masukkan nama proyek. Dalam Kerangka Kerja, pilih .NET Framework 4.7.2 atau yang lebih baru. Tekan Buat.

Tersambung ke Penyimpanan App Configuration

Klik kanan proyek Anda dan pilih Kelola Paket NuGet. Pada tab Telusuri, cari dan tambahkan paket NuGet berikut ke proyek Anda.
- Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration versi 1.0.0 atau yang lebih baru
- Microsoft.Configuration.ConfigurationBuilders.Environment versi 2.0.0 atau yang lebih baru
- System.Configuration.ConfigurationManager versi 4.6.0 atau yang lebih baru

Perbarui fileApp.config proyek Anda sebagai berikut:

<configSections>
    <section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false" />
</configSections>

<configBuilders>
    <builders>
        <add name="MyConfigStore" mode="Greedy" connectionString="${ConnectionString}" type="Microsoft.Configuration.ConfigurationBuilders.AzureAppConfigurationBuilder, Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration" />
        <add name="Environment" mode="Greedy" type="Microsoft.Configuration.ConfigurationBuilders.EnvironmentConfigBuilder, Microsoft.Configuration.ConfigurationBuilders.Environment" />
    </builders>
</configBuilders>

<appSettings configBuilders="Environment,MyConfigStore">
    <add key="AppName" value="Console App Demo" />
    <add key="ConnectionString" value ="Set via an environment variable - for example, dev, test, staging, or production connection string." />
</appSettings>

String koneksi penyimpanan App Configuration Anda dibaca dari variabel lingkungan ConnectionString. Tambahkan pembuat konfigurasi Environment sebelum MyConfigStore di properti configBuilders bagian appSettings.

Pada Program.cs, perbarui metode Main untuk menggunakan Azure App Configuration dengan memanggil metode ConfigurationManager.

static void Main(string[] args)
{
    string message = System.Configuration.ConfigurationManager.AppSettings["TestApp:Settings:Message"];

    Console.WriteLine(message);
    Console.ReadKey();
}

Buat dan jalankan aplikasi

Atur variabel lingkungan bernama ConnectionString ke string koneksi kunci baca-saja yang didapatkan saat pembuatan penyimpanan App Configuration.

Jika Anda menggunakan perintah Windows, jalankan perintah berikut:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Jika Anda menggunakan PowerShell Windows, jalankan perintah berikut:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Hidupkan ulang Visual Studio untuk mengizinkan perubahan diterapkan.
Tekan Ctrl + F5 untuk membangun dan menjalankan aplikasi konsol. Anda akan melihat pesan dari output App Configuration di konsol.

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.

Masuk ke portal Azure, lalu pilih Grup sumber daya.
Dalam kotak Filter menurut nama, masukkan nama grup sumber daya Anda.
Dalam daftar hasil, pilih nama grup sumber daya untuk melihat gambaran umum.
Pilih Hapus grup sumber daya.
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 Framework. Untuk mempelajari cara mengaktifkan aplikasi .NET Framework agar dapat menyegarkan pengaturan konfigurasi secara dinamis, lanjutkan ke tutorial berikutnya.

Mengaktifkan konfigurasi dinamis di aplikasi .NET Framework

Mengaktifkan konfigurasi dinamis di aplikasi Web ASP.NET