التشغيل السريع: إنشاء تطبيق .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.
أنشئ مجلدًا جديدًا لمشروعك.
في المجلد الجديد، قم بتشغيل الأمر التالي لإنشاء مشروع تطبيق وحدة تحكم .NET جديد:
dotnet new console
الاتصال بمخزن تكوين التطبيق
إضافة مرجع إلى
Microsoft.Extensions.Configuration.AzureAppConfiguration
حزمة NuGet عن طريق تشغيل الأمر التالي:dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
تشغيل الأمر التالي لاستعادة الحزم لمشروعك:
dotnet restore
افتح Program.cs، وأضف العبارات التالية:
using Microsoft.Extensions.Configuration; using Microsoft.Extensions.Configuration.AzureAppConfiguration;
استخدم 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!");
يوصى بإنشاء التطبيق وتشغيله محليًا
تعيين environment variable يُسمَّى ConnectionString، وتعيينه إلى مفتاح الوصول إلى متجر App Configuration. في سطر الأوامر، يوصى بتشغيل الأمر التالي:
لإنشاء التطبيق وتشغيله محليًا باستخدام موجه أوامر Windows، قم بتشغيل الأمر التالي:
setx ConnectionString "connection-string-of-your-app-configuration-store"
أعد تشغيل موجه الأمر للسماح بالتغيير لأن يكون حيز التنفيذ. اطبع قيمة متغير البيئة للتحقق من أنه تم تعيينه بشكل صحيح.
يوصى بتشغيل الأمر التالي لإنشاء تطبيق وحدة التحكم:
dotnet build
بعد إنجاز الإنشاء بنجاح، يُرجى تشغيل الأمر التالي لتشغيل التطبيق محليًا:
dotnet run
تنظيف الموارد
إذا كنت لا تريد مواصلة استخدام الموارد التي تم إنشاؤها في هذه المقالة، يوصى بحذف مجموعة الموارد التي أنشأتها هنا لتجنب الرسوم.
هام
حذف مجموعة الموارد لا يمكن التراجع عنه. يتم حذف مجموعة الموارد وجميع الموارد المضمنة فيها نهائيًا. تأكد من عدم حذفك للموارد أو مجموعة المورد الخاطئة عن غير قصد. في حالة إنشاء الموارد لهذه المقالة داخل مجموعة موارد تشتمل على موارد أخرى تريد الاحتفاظ بها، احذف كل مورد على حدة من الجزء الخاص به بدلًا من حذف مجموعة الموارد.
- سجل الدخول إلى مدخل Microsoft Azure، وحدد Resource groups.
- في المربع تصفية حسب الاسم ، أدخل اسم مجموعة الموارد الخاصة بك.
- في قائمة النتائج، حدد اسم مجموعة الموارد لاستعراض نظرة عامة.
- حدد Delete resource group.
- يُطلب منك تأكيد حذف مجموعة الموارد. أدخل اسم مجموعة الموارد للتأكيد وحدد "Delete".
بعد بضع لحظات، يتم حذف مجموعة الموارد وكافة مواردها.
الخطوات التالية
في هذا التشغيل السريع، قمت بإنشاء متجر App Configuration جديد واستخدامه مع تطبيق وحدة تحكم .NET عبر موفر App Configuration. لمعرفة كيفية تكوين تطبيق .NET لتحديث إعدادات التكوين ديناميكيا، تابع إلى البرنامج التعليمي التالي.