Share via

التشغيل السريع: إنشاء تطبيق .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.

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

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

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

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

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

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

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

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

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

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

    • Microsoft.Extensions.Configuration.AzureAppConfiguration الإصدار 1.0.0 أو أحدث
    • Microsoft.Configuration.ConfigurationBuilders.Environment الإصدار 2.0.0 أو أحدث
    • System.Configuration.Configurationاصدار 4.6.0 أو أحدث

  2. قم بتحديث ملف App.config لمشروعك كما يلي:

    <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>

    تتم قراءة سلسلة الاتصال لمتجر App Configuration من متغير ConnectionStringالبيئة . أضف منشئ 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. قم بتعيين متغير بيئة باسم ConnectionString إلى سلسلة اتصال المفتاح للقراءة فقط التي تم الحصول عليها أثناء إنشاء مخزن App Configuration.

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

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

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

    $Env:ConnectionString = "connection-string-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 لتحديث إعدادات التكوين الديناميكي، تابع إلى البرنامج التعليمي التالي.

تمكين التكوين الديناميكي في تطبيق .NET Framework

تمكين التكوين الديناميكي في تطبيق ويب ASP.NET