استكشف مشروع تطبيق Visual Studio خاصتك

  • 5 دقائق

لقد نجحت في إنشاء تطبيق الويب الخاص بك ونشره على Azure. ولكن ماذا يحدث عندما تريد إجراء تغييرات؟ سيتذكر Visual Studio مكان نشر التطبيق، مما يجعل تحديث تطبيقك وتغييره عملية تتم بنقرتين.

استكشف بنية المشروع

لقد أنشأنا تطبيق ويب ASP.NET Core في Visual Studio، والآن ستحتاج إلى تحرير موقع الويب الخاص بك وتخصيصه. لنذهب في رحلة لاكتشاف بنية المشروع لنرى ما أنشأه Visual Studio لنا.

التبعيات

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

خصائص

يحتوي مجلد Properties على بيانات التكوين الخاصة بالمكان الذي تستضيف فيه تطبيق الويب الخاص بك. إذا وسعت المجلد PublishProfiles الآن، يجب أن تشاهد عنوان موقع الويب لموقع Alpine Ski Hill. كل ملف تعريف النشر هو ملف ‎.xml يحتوي على معلومات تكوين النشر مثل عنوان Azure الذي يستخدمه Visual Studio لتحميل الملفات.

wwwroot

يحتوي ملف wwwroot على جميع الأصول الثابتة لموقعك، مثل ملفات css وjs والصور وملفات lib. عندما تكون جاهزا لإضفاء نمط وإضافة المزيد من الوظائف إلى موقعك، ستعمل هنا.

الصفحات

يتضمن المجلد Pages قوالب Razor لصفحات موقعك. Razor هو بناء علامات ترميز لتضمين رمز الخادم في صفحات الويب ASP.NET. ويضم HTML وبعض الاصطلاحات الخاصة لعرض البيانات وتنفيذ المنطق على موقعك.

تُمثل كل صفحة في موقعك مع ملفي التعليمات البرمجية:

  • ملف .cshtml، وهو ملف علامات Razor. يتضمن هذا الملف عرض HTML الخاص بك وبعض من منطق #C.

  • ملف .cs، وهو تعليمة برمجية C# خلفية تأخذ صفات من الفئة PageModel. يسمح لك هذا الملف باعتراض طلبات HTTP وتنفيذ بعض المعالجة على ذلك الطلب قبل تمرير أي بيانات إلى ملف Razor.

appsetting.json

هذا ملف تكوين ASP.NET Core.

Program.cs

يقوم ملف Program.cs بتكوين مضيف الويب لموقعك وتشغيله.

مقدمة عن قوالب Razor

سنرغب في إجراء بعض التغييرات الأساسية على موقعنا على الويب. ستحتاج إلى فهم أساسيات كيفية الاستفادة من قوالب Razor لتخصيص تطبيق الويب خاصتك.

ما هو Razor؟

Razor هو بناء ASP.NET اُستخدم لإنشاء صفحات ويب ديناميكية باستخدام #C. عندما يقرأ الخادم صفحة Razor، يتم تشغيل التعليمة البرمجية C# قبل أن يعرض HTML. هذا يسمح لك بإنشاء محتوى ديناميكي بسرعة.

تستخدم Razor توجيهات @ لإخبار ASP.NET بكيفية معالجة الصفحة.

على سبيل المثال، ألقِ نظرة على التعليمة البرمجية في صفحة Privacy.cshtml:

@page
@model PrivacyModel
@{
    ViewData["Title"] = "Privacy Policy";
}
<h1>@ViewData["Title"]</h1>

<p>Use this page to detail your site's privacy policy.</p>
  • يعمل التوجيه @pageعلى توجيه ASP.NET لمعالجة هذا الملف كصفحة Razor.
  • يعمل التوجيه @modelعلى توجيه ASP.NET لربط صفحة Razor هذه مع فئة تسمى #C PrivacyModel.

تستخدم Razor @ أيضًا الرمز للانتقال بين التعليمات البرمجية وHTML. إذا نظرت إلى القصاصة البرمجية السابقة، ستلاحظ @{ ... }. هذا هو Razor code block، الذي ينفذ ولكن لم يعرض.

لتقديم ناتج بيان التعليمة البرمجية، استخدم @ أمام تعبير #C. يوجد مثال واحد في كتلة التعليمات البرمجية السابقة في العلامة <h1>.

يعد إنشاء موقع ويب ونشره مجرد خطوات أولى في إنشاء موقع ويب جيد. بمجرد البدء في إضافة المحتوى، ستحتاج إلى تحديث موقعك. بمجرد نشر موقعك على Azure مبدئيًا، يمكنك تحديثه في أي وقت.