التشغيل السريع: إنشاء تطبيق .NET باستخدام App Configuration

في هذا التشغيل السريع، يمكنك دمج Azure App Configuration في تطبيق وحدة تحكم .NET لمركزية التخزين وإدارة إعدادات التطبيق بشكل منفصل عن التعليمات البرمجية الخاصة بك.

المتطلبات الأساسية

• حساب Azure مع اشتراك نشط. أنشئ حسابًا مجانًا.
• متجر App Configuration. إنشاء متجر.
• .NET SDK 6.0 أو أحدث - متوفر أيضا في Azure Cloud Shell.

إضافة قيمة مفتاح

أضف قيمة المفتاح التالية إلى متجر App Configuration واترك Label و Content Type بقيمهما الافتراضية. لمزيد من المعلومات حول كيفية إضافة قيم المفاتيح إلى مخزن باستخدام مدخل Microsoft Azure أو CLI، انتقل إلى إنشاء قيمة مفتاح.

مفتاح	القيمة
TestApp:الإعدادات:Message	البيانات من Azure App Configuration

إنشاء تطبيق NET console

يمكنك استخدام واجهة سطر الأوامر .NET (CLI) لإنشاء مشروع تطبيق وحدة تحكم .NET جديد. تتمثل ميزة استخدام .NET CLI على Visual Studio في أنه متاح عبر الأنظمة الأساسية Windows وmacOS وLinux. بدلا من ذلك، استخدم الأدوات المثبتة مسبقا المتوفرة في Azure Cloud Shell.

1. أنشئ مجلدًا جديدًا لمشروعك.

2. في المجلد الجديد، قم بتشغيل الأمر التالي لإنشاء مشروع تطبيق وحدة تحكم .NET جديد:

   dotnet new console
   

الاتصال بمخزن تكوين التطبيق

1. إضافة مرجع إلى Microsoft.Extensions.Configuration.AzureAppConfiguration حزمة NuGet عن طريق تشغيل الأمر التالي:

   dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
   

2. تشغيل الأمر التالي لاستعادة الحزم لمشروعك:

   dotnet restore
   

3. افتح Program.cs، وأضف العبارات التالية:

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.Configuration.AzureAppConfiguration;
   

4. استخدم App Configuration عن طريق استدعاء AddAzureAppConfiguration الأسلوب في Program.cs الملف.

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

يوصى بإنشاء التطبيق وتشغيله محليًا

1. تعيين environment variable يُسمَّى ConnectionString، وتعيينه إلى مفتاح الوصول إلى متجر App Configuration. في سطر الأوامر، يوصى بتشغيل الأمر التالي:

   واجهة أوامر Windows

   لإنشاء التطبيق وتشغيله محليًا باستخدام موجه أوامر Windows، قم بتشغيل الأمر التالي:

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

   أعد تشغيل موجه الأمر للسماح بالتغيير لأن يكون حيز التنفيذ. اطبع قيمة متغير البيئة للتحقق من أنه تم تعيينه بشكل صحيح.

   بوويرشيل

   إذا كنت تستخدم Windows PowerShell، فقم بإجراء الأمر التالي:

   $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
   

   ماك

   إذا كنت تستخدم macOS، فقم بتشغيل الأمر التالي:

   export ConnectionString='connection-string-of-your-app-configuration-store'
   

   Linux

   إذا كنت تستخدم macOS، فقم بتشغيل الأمر التالي:

   export ConnectionString='connection-string-of-your-app-configuration-store'
   

2. يوصى بتشغيل الأمر التالي لإنشاء تطبيق وحدة التحكم:

   dotnet build
   

3. بعد إنجاز الإنشاء بنجاح، يُرجى تشغيل الأمر التالي لتشغيل التطبيق محليًا:

   dotnet run
   

تنظيف الموارد

إذا كنت لا تريد مواصلة استخدام الموارد التي تم إنشاؤها في هذه المقالة، يوصى بحذف مجموعة الموارد التي أنشأتها هنا لتجنب الرسوم.

هام

حذف مجموعة الموارد لا يمكن التراجع عنه. يتم حذف مجموعة الموارد وجميع الموارد المضمنة فيها نهائيًا. تأكد من عدم حذفك للموارد أو مجموعة المورد الخاطئة عن غير قصد. في حالة إنشاء الموارد لهذه المقالة داخل مجموعة موارد تشتمل على موارد أخرى تريد الاحتفاظ بها، احذف كل مورد على حدة من الجزء الخاص به بدلًا من حذف مجموعة الموارد.

1. سجل الدخول إلى مدخل Microsoft Azure، وحدد Resource groups.
2. في المربع تصفية حسب الاسم ، أدخل اسم مجموعة الموارد الخاصة بك.
3. في قائمة النتائج، حدد اسم مجموعة الموارد لاستعراض نظرة عامة.
4. حدد Delete resource group.
5. يُطلب منك تأكيد حذف مجموعة الموارد. أدخل اسم مجموعة الموارد للتأكيد وحدد "Delete".

بعد بضع لحظات، يتم حذف مجموعة الموارد وكافة مواردها.

الخطوات التالية

في هذا التشغيل السريع، قمت بإنشاء متجر App Configuration جديد واستخدامه مع تطبيق وحدة تحكم .NET عبر موفر App Configuration. لمعرفة كيفية تكوين تطبيق .NET لتحديث إعدادات التكوين ديناميكيا، تابع إلى البرنامج التعليمي التالي.

تمكين التكوين الديناميكي