ASP.NET Core لـ C# (.NET): دليل شامل مع أمثلة

ما هو ASP.NET Core ولماذا هو مطلوب؟

ASP.NET Core هو إطار عمل ويب حديث، متعدد المنصات، عالي الأداء ومفتوح المصدر من Microsoft، مصمم لإنشاء تطبيقات الويب، واجهات برمجة التطبيقات (API)، الخدمات المصغرة والحلول السحابية بلغة C# (.NET). على عكس ASP.NET الكلاسيكي (Framework) الذي كان يعمل فقط على Windows، فإن ASP.NET Core متعدد المنصات بالكامل: يعمل على Windows و Linux و macOS.

لماذا هو مطلوب؟ يوفر ASP.NET Core للمطورين مجموعة أدوات قوية لإنشاء تطبيقات الويب الحديثة. يتضمن دعمًا مدمجًا لحقن التبعيات (Dependency Injection)، الوسائط (middleware)، التوجيه، المصادقة، العمل مع قواعد البيانات عبر Entity Framework Core وغيرها الكثير. تم تحسين الإطار للأداء العالي وقابلية التوسع، مما يجعله الخيار الأمثل لإنشاء كل من المواقع الصغيرة والأنظمة المؤسسية الكبيرة.

المزايا الرئيسية لـ ASP.NET Core:

\n
• تعدد المنصات: يعمل على Windows و Linux و macOS.
\n
• أداء عالٍ: واحد من أسرع أطر العمل الويب.
\n
• قابلية التوسع المعيارية: تقوم بتوصيل المكونات التي يحتاجها تطبيقك فقط.
\n
• دعم مدمج لـ Dependency Injection: يبسط اختبار الكود وصيانته.
\n
• مفتوح المصدر: الكود المصدري متاح على GitHub، والمجتمع يطور الإطار بنشاط.
\n
• نموذج برمجة موحد: يمكنك إنشاء تطبيقات MVC، Web API، Razor Pages، Blazor و SignalR.
\n

تثبيت ASP.NET Core

للبدء في العمل مع ASP.NET Core، تحتاج إلى تثبيت .NET SDK (مجموعة أدوات تطوير البرامج). هذه ليست حزمة يتم تثبيتها عبر pip أو npm، بل هي بيئة تطوير كاملة.

خطوات التثبيت:

\n
1. قم بتنزيل .NET SDK: انتقل إلى الموقع الرسمي dotnet.microsoft.com/download وقم بتنزيل أحدث إصدار من .NET SDK لنظام التشغيل الخاص بك (Windows، Linux، macOS).
\n
2. قم بتثبيت SDK: قم بتشغيل برنامج التثبيت واتبع التعليمات. بعد التثبيت، أعد تشغيل الكمبيوتر (أو الطرفية).
\n
3. تحقق من التثبيت: افتح الطرفية (سطر الأوامر) وقم بتنفيذ الأمر:\n

   dotnet --version

   \n إذا رأيت رقم الإصدار (مثل 8.0.100)، فقد تم التثبيت بنجاح.
\n

بعد تثبيت SDK، سيكون لديك إمكانية الوصول إلى الأمر dotnet، والذي يستخدم لإنشاء المشاريع وبنائها وتشغيلها.

بداية سريعة مع مثال كود

لنقم بإنشاء تطبيق ويب بسيط ASP.NET Core (Web API) سيعيد "Hello, World!".

الخطوة 1: إنشاء المشروع

افتح الطرفية وقم بتنفيذ الأمر:

dotnet new webapi -n MyFirstApi\ncd MyFirstApi

سينشئ هذا الأمر مشروع Web API جديد باسم MyFirstApi وينتقل إلى مجلده.

الخطوة 2: هيكل المشروع

في مجلد المشروع، سترى عدة ملفات. أهمها:

\n
• Program.cs — نقطة الدخول إلى التطبيق، حيث يتم تكوين خط أنابيب معالجة الطلبات.
\n
• MyFirstApi.csproj — ملف المشروع الذي يحتوي على التبعيات وإعدادات البناء.
\n
• Controllers/ — مجلد لوحدات التحكم (بشكل افتراضي، يوجد بالفعل WeatherForecastController.cs).
\n

الخطوة 3: تشغيل التطبيق

قم بتنفيذ الأمر في الطرفية:

dotnet run

بعد التشغيل، سترى رسالة تفيد بأن التطبيق يعمل على http://localhost:5xxx (قد يختلف المنفذ). افتح المتصفح وانتقل إلى العنوان http://localhost:5xxx/weatherf