التشغيل السريع: إنشاء تطبيق .NET Framework باستخدام تكوين تطبيق Azure

هناك طريقتان لدمج Azure App Configuration في تطبيق يستند إلى .NET Framework.

• يمكن منشئ التكوين لـ App Configuration من تحميل البيانات من App Configuration إلى App Settings. يصل التطبيق إلى التكوين كما يفعل دائماً عبر ConfigurationManager. لا تحتاج إلى إجراء أي تغيير في التعليمات البرمجية بخلاف التحديثات لملفات app.config أو web.config. يرشدك هذا التشغيل السريع خلال هذا الخيار.
• كما تم تصميمه من قبل .NET Framework، يمكن تحديثApp Settings فقط عند إعادة تشغيل التطبيق. إن موفر App Configuration .NET عبارة عن مكتبة قياسية.NET. يدعم التخزين المؤقت وتحديث التكوين بشكل ديناميكي دون إعادة تشغيل التطبيق. إذا كان التكوين الديناميكي ضروريا لك وكنت على استعداد لإجراء تغييرات في التعليمات البرمجية، فشاهد البرامج التعليمية حول كيفية تنفيذ تحديثات التكوين الديناميكية في تطبيق وحدة تحكم .NET Framework أو تطبيق ويب ASP.NET.

في هذه البداية السريعة، يتم استخدام تطبيق وحدة تحكم .NET Framework كمثال، ولكن نفس التقنية تنطبق على تطبيق ASP.NET نماذج ويب/MVC.

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

• حساب Azure مع اشتراك نشط. أنشئ حسابًا مجانًا.
• متجر App Configuration. إنشاء متجر.
• Visual Studio
• .NET Framework 4.7.2 أو أحدث

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

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

إنشاء تطبيق وحدة تحكم .NET Framework

1. افتح Visual Studio، وحدد Create a new project.

2. في إنشاء مشروع جديد، قم بالتصفية على نوع المشروع من حيث وحدة التحكم وحدد تطبيق وحدة التحكم (.NET Framework) مع C# من قائمة قالب المشروع. اضغط Next.

3. في تكوين المشروع الجديد،أدخل اسم المشروع. ضمن Framework، حدد .NET Framework 4.7.2 أو أعلى. اضغط على إنشاء.

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

اتصل بمخزن App Configuration باستخدام معرف Microsoft Entra (مستحسن) أو سلسلة الاتصال.

1. حدد بزر الماوس الأيمن على المشروع، وحدد Manage NuGet Packages. في علامة التبويب استعراض ، ابحث عن أحدث الإصدارات الثابتة من حزم NuGet التالية وأضفها إلى مشروعك.

   • Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration
   • Microsoft.Configuration.ConfigurationBuilders.Environment
   • System.Configuration.ConfigurationManager

2. قم بتحديث ملف App.config لمشروعك كما يلي. يمكنك الاتصال بمخزن App Configuration باستخدام معرف Microsoft Entra (مستحسن) أو سلسلة الاتصال.

   • معرف Microsoft Entra (مستحسن)
   • سلسلة الاتصال

   DefaultAzureCredential يتم استخدام للمصادقة على متجر App Configuration بشكل افتراضي. اتبع الإرشادات لتعيين بيانات الاعتماد الخاصة بك دور قارئ بيانات تكوين التطبيق. تأكد من السماح بوقت كاف للإذن للنشر قبل تشغيل التطبيق الخاص بك.

   <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" endpoint="${Endpoint}" 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="Endpoint" value ="Set via an environment variable - for example, dev, test, staging, or production endpoint." />
   </appSettings>
   

   تتم قراءة قيمة نقطة النهاية لمتجر App Configuration من متغير Endpointالبيئة . يمكنك أيضا إضافة منشئ Environment التكوين قبل MyConfigStore في configBuilders خاصية المقطع appSettings .

3. افتح Program.cs، وقم بتحديث Main الأسلوب لاستخدام App Configuration عن طريق استدعاء ConfigurationManager.

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

إنشاء وتشغيل التطبيق

1. تعيين متغير بيئة.

   • معرف Microsoft Entra (مستحسن)
   • سلسلة الاتصال

   قم بتعيين متغير بيئة يسمى Endpoint إلى نقطة النهاية لمتجر App Configuration الموجود ضمن نظرة عامة على متجرك في مدخل Microsoft Azure.

   إذا كنت تستخدم موجه الأوامر Windows، فشغل الأمر التالي، ثم أعد تشغيل موجه الأوامر للسماح للتغيير بتنفيذ الأمر:

   setx Endpoint "<endpoint-of-your-app-configuration-store>"
   

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

   $Env:Endpoint = "<endpoint-of-your-app-configuration-store>"
   

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

   export Endpoint='<endpoint-of-your-app-configuration-store>'
   

2. أعد تشغيل Visual Studio للسماح بتغييرات حيز التنفيذ.

3. اضغط على Ctrl + F5 لإنشاء تطبيق وحدة التحكم وتشغيله. يجب أن تشاهد الرسالة من مخرجات App Configuration في وحدة التحكم.

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

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

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

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

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

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