Software Engineer Encyclopedia
0%
Domain 03 · Backend Engineering & Web Development · Topic 3.6

MVC في ASP.NET Core: Model وView وController

ASP.NET Core MVC

فهم نمط MVC وRazor Views وrouting وmodel binding وvalidation وfilters وDI والفرق بين MVC وWeb API واختيار الاستخدام المناسب.

  • Intermediate
  • ~13 min read
  • 9 sections
  • 9 code examples
  • 1 diagrams
  • 4 questions
  • Priority L3 · Optional
  • ASP.NET Core 10 · .NET 10 · C# 14

المتطلبات قبل ما تبدأ

C# و.NET (المجال 02) والـ HTTP/Networking (درس 1.2).

مستوى التعمق المطلوب

BASICSUnderstand the model and be able to read a conventional MVC application.

01

MVC يعني إيه؟

Model · View · Controller responsibilities
Basics

MVC pattern بيفصل application interaction إلى Model يحمل البيانات/السلوك، View مسؤولة عن presentation، و Controller يستقبل request ويختار model ويحدد response. في ASP.NET Core MVC التقليدي، الـ View غالباً Razor (.cshtml) تُrender على السيرفر إلى HTML، بينما Web API controller يرجع بيانات/HTTP results للـ clients.

Model

View model أو domain/application data؛ لا تفترض أنه نفس EF entity.

View

Razor template يحوّل model إلى HTML. استخدم encoding الافتراضي وتجنب raw HTML غير الموثوق.

Controller

HTTP adapter ينسق التعامل مع request ويعيد View أو Redirect أو StatusCode.

رحلة Request داخل MVC

بعد middleware و endpoint routing، MVC يختار controller/action المناسبة. ثم ينفذ authorization filters، resource filters، model binding و validation، action filters، action method، result filters، ثم result execution. الترتيب مهم لأن filter قد يمنع تنفيذ action أو يعدّل result. ده يختلف عن middleware الذي يحيط بالـ HTTP pipeline كلها.

RoutingFiltersBindingActionResultResponse is written after action result execution
MVC action invocation pipeline بصورة مبسطة.

الـ Model binding يحاول تحويل route/query/form/body إلى parameters. بعدها validation تنتج ModelState errors. مع [ApiController] قد يرجع framework 400 تلقائياً عند invalid model state. في MVC Views التقليدية غالباً ترجع نفس view مع validation messages حتى المستخدم يصلح input.

MVC: إيه اللي لازم تكون فاهمه بعد الدرس؟

تقدر تقرأ route وتعرف controller/action، تفهم model binding و ModelState، تفرق بين ViewModel و Entity، تبني Razor View مع Tag Helpers و validation messages، تحمي POST forms من CSRF، وتعرف إمتى تستخدم filters ومتى middleware. كمان تقدر تشرح الفرق بين MVC Views و API controllers و Minimal APIs.

لو هدفك backend/mobile API، MVC Views معرفة مهمة لقراءة applications تقليدية، لكنها ليست أولوية أعلى من HTTP semantics و DI و middleware و API security. لا تتعمق في Razor rendering internals قبل إتقان API boundary.

02

Routing و Model Binding و Validation

From route to action parameters
Practical
C#MVC controller action
[Route("catalog")]
public sealed class CatalogController(IProductQuery products) : Controller
{
    [HttpGet("{id:int}")]
    public async Task<IActionResult> Details(int id, CancellationToken token)
    {
        var product = await products.FindAsync(id, token);
        if (product is null) return NotFound();
        return View(new ProductDetailsViewModel(product.Id, product.Name));
    }
}

public sealed record ProductDetailsViewModel(int Id, string Name);

Routing يختار action حسب route template و HTTP verb. Model binding يملأ action parameters من route/query/form/body حسب binder attributes/conventions. Validation تتحقق من DTO/ViewModel قبل منطق الـ action؛ لا تعتمد على client-side validation فقط، لأن client يمكن تجاوزه.

Binding و Anti-Forgery و Overposting

في browser-based MVC forms، model binding من form fields يحتاج حماية CSRF/antiforgery عندما authentication تعتمد على cookies. Form Tag Helper غالباً يضيف antiforgery token في forms التي تستخدم POST، و validation يتم server-side حتى لو عندك client-side validation. لا تعتمد على JavaScript validation فقط.

Overposting يحدث لما تستقبل entity فيها حقول لا ينبغي للعميل تعديلها. استخدم input ViewModel يضم الحقول المسموح بها فقط. مثلاً لا تستقبل IsAdmin أو OwnerId من form إذا النظام هو الذي يحددهم. وبعد binding، تحقق من authorization على المورد الحالي.

HTMLA constrained form model
@model EditProfileViewModel
<form asp-action="Edit" method="post">
    <input asp-for="DisplayName" />
    <span asp-validation-for="DisplayName"></span>
    <button type="submit">Save</button>
</form>

Conventional Routing و Attribute Routing

Conventional routing يستخدم route template عام مثل {controller=Home}/{action=Index}/{id?} ويختار controller/action بالاسم. Attribute routing يربط route مباشرة بالـ controller/action، وهو شائع في APIs. Route constraints مثل {id:int} تساعد route selection لكنها لا تتحقق من وجود record أو permission.

C#Conventional and attribute routes
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

[Route("catalog/products")]
public sealed class ProductsController : Controller
{
    [HttpGet("{id:int}")]
    public IActionResult Details(int id) => View();
}

لو route templates متداخلة أو ambiguous، framework قد يختار حسب precedence أو يرجع ambiguity error. استخدم routes واضحة ولا تعتمد على route order كحل لكل conflict.

ModelState و Validation Messages

في MVC form، model binding يملأ ViewModel ثم validation تملأ ModelState. لو invalid، رجّع نفس view مع نفس model والـ validation messages. لا تنفذ database update قبل التأكد من ModelState. Client-side validation لتحسين UX فقط؛ server-side validation هي authority لأن client يمكن تعطيله أو إرسال HTTP request مباشرة.

C#MVC action pattern
[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Edit(EditProfileViewModel model,
    CancellationToken token)
{
    if (!ModelState.IsValid)
        return View(model);

    await profileService.UpdateAsync(model, token);
    return RedirectToAction(nameof(Details));
}

بعد POST الناجح، Post/Redirect/Get يقلل إعادة إرسال form عند refresh. لو update فشل بسبب concurrency، أضف ModelState error أو اعرض conflict page حسب UX. لا تعرض exception تفاصيلها للمستخدم.

03

Razor Views و HTML Rendering

View discovery and safe rendering
Practical

View عادة في Views/{Controller}/{Action}.cshtml، و shared layout/partial views في مجلدات مشتركة. Razor يخلط HTML مع C#‎ expressions باستخدام @. القيمة النصية تُعمل لها HTML encoding تلقائياً في المعتاد؛ تجنب Html.Raw مع input غير موثوق لأنه يفتح XSS.

HTMLViews/Catalog/Details.cshtml
@model ProductDetailsViewModel

<h1>@Model.Name</h1>
<p>Product ID: @Model.Id</p>
<a asp-controller="Catalog" asp-action="Index">Back to catalog</a>

Razor Views و ViewModels

Razor View تعرض HTML، وغالباً تستخدم ViewModel مخصص للصفحة بدلاً من EF entity. الـ @model يحدد strongly typed model. Razor يعمل HTML encoding تلقائياً في expressions العادية، وده يقلل XSS؛ لا تستخدم Html.Raw مع input غير موثوق. Partial views تعيد استخدام markup، و View Components مناسبة لقطعة UI لها منطق/تحميل مستقل.

HTMLViews/Products/Details.cshtml
@model ProductDetailsViewModel

<h1>@Model.Name</h1>
<p class="price">@Model.Price.ToString("C")</p>

@if (Model.IsAvailable)
{
    <span class="status">Available</span>
}
else
{
    <span class="status">Out of stock</span>
}

ViewModel ليس بالضرورة DTO الخاص بالـ API؛ هو model مخصص لعرض صفحة. تجنب وضع persistence entity مباشرة في view لأن view قد تعرض أو تعدّل حقول غير مقصودة، ولأن schema changes قد تؤثر على UI.

Post/Redirect/Get و TempData

Post/Redirect/Get pattern: POST يعالج form، ثم redirect إلى GET page. ده يقلل duplicate submission عند refresh، ويسمح بعرض success message عبر TempData. لا تخزن object كبير أو secret في TempData؛ هي لرسالة/علامة قصيرة. لو validation فشلت، ارجع View مباشرة مع ModelState والـ input model.

لا تستخدم redirect بعد كل validation error؛ المستخدم يحتاج يشوف messages والحقول المعبأة. ولا تعتمد على client-side validation فقط. لو operation حساس، أضف idempotency أو concurrency control حسب business effect.

Partial Views و View Components

Partial View تعيد استخدام markup داخل View، وتأخذ model صغيراً. View Component مناسبة لقطعة UI لها logic أو data retrieval خاص بها، مثل navigation menu أو cart summary. لا تستخدم View Component لمجرد تقسيم HTML؛ لو ليس لديها responsibility واضحة، partial أبسط. ولا تجعل كل component تنفذ DB query مستقلة بلا داعٍ لأن الصفحة قد تتحول إلى N+1 من الـ UI layer.

Layout يحدد الهيكل العام، Sections تسمح للـ view تضيف scripts/styles في مواضع محددة، و Tag Helpers تسهل إنشاء links/forms مع routing و antiforgery. استخدم strongly typed view models لتوضيح ما تحتاجه الصفحة.

ViewModel Composition و UI Boundaries

ViewModel ممكن يجمع بيانات من أكثر من domain model للعرض: customer name، order status، list of lines، permissions لإظهار button. ده لا يعني أن ViewModel هو domain entity. اجعل أسماءه مرتبطة بالصفحة/feature، ولا تعيد استخدام ViewModel واحد لكل create/edit/details إذا fields وال validation تختلف.

عند POST، اعمل mapping من input ViewModel إلى command/use case بعد validation و authorization. لا تربط form مباشرة بـ EF entity. لو الصفحة تحتاج select options، جهزها في controller/application query، وتأكد من إعادة تعبئتها عند ModelState invalid حتى لا تختفي القوائم من الشاشة.

ActionResult و Redirect و File Results

MVC result types تشمل ViewResult لعرض Razor view، RedirectToActionResult للتنقل بعد POST، JsonResult للـ JSON في بعض السيناريوهات، FileResult لتنزيل ملف، و NotFound/BadRequest/Unauthorized results. اختار result حسب consumer؛ لا ترجع ViewResult من API endpoint يتوقع JSON. File result يحتاج authorization و content disposition/filename safe، ولا تستخدم path من user مباشرة.

Action method تنسق HTTP behavior؛ business operation في service. لو action ترجع View، model يكون ViewModel. لو ترجع API response، model يكون DTO. افصلهم حتى لا يتسرب UI concern أو database schema إلى contract آخر.

04

Dependency Injection و Filters في MVC

Controller activation and action filters
Practical

Controllers و Razor infrastructure تُنشأ عبر ASP.NET Core DI، لذا constructor injection هو النمط المعتاد. لا تنشئ database context داخل controller يدوياً. Filters تضيف behavior حول MVC actions/results؛ راجع درس Middleware للتمييز: middleware يشمل كل HTTP pipeline، بينما filters تخص MVC.

C#Register MVC and a filter
builder.Services.AddControllersWithViews(options =>
{
    options.Filters.Add<AuditActionFilter>();
});
builder.Services.AddScoped<AuditActionFilter>();

Filters و DI واختيار مكان السلوك

Middleware مناسب لسلوك HTTP عام مثل exception handling و correlation ID. MVC filters مناسبة لما يحتاج معرفة action/controller metadata أو model state أو result. Dependency injection متاح في controllers و filters و view components. لا تحوّل filter إلى مكان business logic؛ خليها cross-cutting concern رفيعة.

لو filter تحتاج scoped dependency، سجّلها عبر DI أو استخدم ServiceFilter/TypeFilter وفق الحالة. Attribute filter قد تُنشأ بطريقة لا تسمح بحقن dependencies مباشرة من constructor العادي. راجع lifetime لأن filter قد تعمل على requests متعددة إذا كانت singleton.

DI في Controllers و Filters

Controllers يمكنها constructor injection من DI، والـ controller instance عادة per request. استخدم service interfaces حسب responsibility. لا تحقن IServiceProvider وتعمل resolve عشوائي داخل كل action؛ ده Service Locator ويخفي dependencies. Filters لها طرق DI مختلفة حسب هل هي attribute أو registered filter service. راجع lifetime حتى لا تحتفظ scoped service في singleton filter.

Action filters قد تكون global أو controller-level أو action-level. لو نفس concern ينطبق على كل HTTP request، middleware غالباً أوضح. لو مرتبط ب MVC action metadata، filter مناسب. Authorization الأفضل يكون policy-based بدلاً من custom filter يقرأ roles بنفسه.

MVC Filter Order و Short-circuiting

Authorization filters تعمل مبكراً، Resource filters تحيط بالـ resource execution قبل model binding، Action filters تحيط بتنفيذ action، Exception filters تتعامل مع exceptions داخل MVC action pipeline، و Result filters تحيط بتنفيذ action result. كل filter يمكن أن يكون global أو controller/action scoped حسب النوع. ترتيب filters يتأثر بالـ order والـ scope؛ لا تعتمد على ترتيب تسجيل غير واضح.

Filter قد تعمل short-circuit بإنتاج result من غير استدعاء next. ده مفيد لبعض caching/resource concerns، لكنه قد يمنع action من التنفيذ؛ لا تستخدمه لإخفاء business errors أو تجاوز validation. استخدم middleware للـ cross-cutting HTTP concern العام.

05

MVC vs Web API: تختار إيه؟

Server-rendered pages vs HTTP data APIs
Basics
QuestionMVC with ViewsWeb API
Primary outputHTML pagesJSON/HTTP representations
Typical clientBrowser navigationSPA, mobile, services
PresentationServer-side RazorUsually client-side UI
Best fitContent/site pages, server-rendered formsReusable service contract

اختَر MVC عندما يكون server-rendered HTML مناسباً ويقلل تعقيد frontend منفصل. اختَر Web API عندما تحتاج mobile/SPA/multiple clients أو public integration. يمكن للتطبيق الواحد أن يحتوي MVC views و API endpoints، لكن افصل contracts وسياسات security الخاصة بكل منهما بوضوح.

MVC ولا Web API؟ وإمتى MVC مناسب؟

ASP.NET Core MVC يدعم صفحات HTML مع Razor Views، ويدعم API controllers أيضاً عبر ControllerBase. اختار MVC Views عندما الخادم مسؤول عن HTML navigation/forms/pages. اختار Web API عندما client مستقل مثل mobile app أو Angular SPA يستهلك JSON. ممكن تطبيق واحد يقدم الاثنين، لكن افصل route areas والـ security policies و view models عن API contracts.

في تطبيقات SPA حديثة، MVC قد يظل مفيداً لصفحات admin أو authentication UI أو server-rendered pages. لا تتعلم MVC على حساب API fundamentals لو هدفك mobile/backend، لكن افهمه بما يكفي لقراءة legacy applications ومقابلات ASP.NET Core.

إمتى ما تختارش MVC Views؟

لو client هو Angular أو mobile app مستقل، غالباً Web API JSON contract أنسب من Razor Views. لو التطبيق صفحات server-rendered، forms، navigation، و SEO محتاجين HTML من server، MVC Views اختيار طبيعي. لو عندك mix، تقدر تجمع MVC و API controllers في نفس host لكن افصل routes, DTOs, auth policies, و view models.

لا تخلط Razor View model مع API response DTO لمجرد تشابه fields؛ كل واحد يخدم consumer مختلف. واعرف MVC بما يكفي لقراءة legacy apps ويفهمك filters/model binding، لكن الأولوية في backend API roadmap تكون لـ HTTP pipeline و API contracts.

06

مثال كامل: صفحة Edit في MVC بأمان

A complete, safe edit flow
Practical

صفحة تعديل بيانات عميل هي أصغر مثال بيجمع كل مخاطر MVC: overposting، CSRF، validation، concurrency، و PRG. ده التنفيذ اللي تقدر تعتمد عليه كـ template.

C#CustomersController.cs
public sealed class CustomerEditVm
{
    public Guid Id { get; init; }
    [Required, StringLength(80)] public string Name { get; set; } = "";
    [EmailAddress] public string? Email { get; set; }
    public byte[] RowVersion { get; set; } = [];            // optimistic concurrency token round-trips through a hidden field
    // NOTE: no IsVip / CreditLimit here -> they cannot be overposted from the form
}

[Authorize(Policy = "customers:write")]
public sealed class CustomersController(AppDb db) : Controller
{
    [HttpGet]
    public async Task<IActionResult> Edit(Guid id, CancellationToken ct)
    {
        var c = await db.Customers.AsNoTracking().SingleOrDefaultAsync(x => x.Id == id, ct);
        if (c is null) return NotFound();
        return View(new CustomerEditVm { Id = c.Id, Name = c.Name, Email = c.Email, RowVersion = c.RowVersion });
    }

    [HttpPost, ValidateAntiForgeryToken]
    public async Task<IActionResult> Edit(Guid id, CustomerEditVm vm, CancellationToken ct)
    {
        if (id != vm.Id) return BadRequest();
        if (!ModelState.IsValid) return View(vm);                                  // redisplay with messages

        var c = await db.Customers.SingleOrDefaultAsync(x => x.Id == id, ct);      // tenant query filter applies
        if (c is null) return NotFound();
        db.Entry(c).Property(x => x.RowVersion).OriginalValue = vm.RowVersion;
        c.Rename(vm.Name); c.ChangeEmail(vm.Email);
        try { await db.SaveChangesAsync(ct); }
        catch (DbUpdateConcurrencyException)
        {
            ModelState.AddModelError("", "Someone else changed this customer. Reload and try again.");
            return View(vm);
        }
        TempData["Flash"] = "Customer updated";
        return RedirectToAction(nameof(Details), new { id });                     // PRG: refresh won't re-submit
    }
}
HTMLViews/Customers/Edit.cshtml
@model CustomerEditVm
<form asp-action="Edit" asp-route-id="@Model.Id" method="post">   <!-- tag helper adds the antiforgery token -->
  <div asp-validation-summary="ModelOnly" class="error-summary" role="alert"></div>
  <input type="hidden" asp-for="Id" />
  <input type="hidden" asp-for="RowVersion" />
  <label asp-for="Name"></label>
  <input asp-for="Name" aria-describedby="name-err" />
  <span asp-validation-for="Name" id="name-err"></span>
  <label asp-for="Email"></label>
  <input asp-for="Email" />
  <span asp-validation-for="Email"></span>
  <button type="submit">Save</button>
</form>
الخطرالحماية في المثال
OverpostingViewModel فيه الحقول المسموحة بس، مش الـ entity
CSRF[ValidateAntiForgeryToken] + token من الـ form tag helper (أو AutoValidateAntiforgeryTokenAttribute globally)
Lost updateRowVersion في hidden field + DbUpdateConcurrencyException
Double submitPost/Redirect/Get
IDORAuthorization policy + tenant query filter؛ لو فيه ownership، resource-based authorization
XSSRazor بيعمل HTML-encode تلقائي؛ تجنب Html.Raw مع بيانات المستخدم
07

MVC/Razor Pages في 2026: إمتى لسه الاختيار الصح؟

Server-rendered UI today
Deep dive

مش كل واجهة محتاجة SPA. لوحات admin داخلية، نماذج CRUD كتير، مواقع محتوى، وتطبيقات فريقها backend أساسًا — server-rendered بيدّي: SEO وأول تحميل سريع، أمان أبسط (cookies + antiforgery بدون CORS و token storage)، ونشر واحد. تقنيات زي htmx (طلبات جزئية بترجع HTML fragments) بتدّي تفاعل معقول من غير framework كامل. Razor Pages (page-focused) غالبًا أبسط من MVC للصفحات المستقلة، وBlazor خيار لو عايز components بـ C#‎. الاختيار بيعتمد على: هل فيه تفاعل client-side غني (drag-drop، offline، real-time كتير)؟ هل فيه فريق frontend؟ هل نفس الـ API هيخدم موبايل؟ لو الإجابات «لا»، server-rendered غالبًا أرخص.

(Mid) MVC app بيظهر نفس الـ flash message مرتين بعد الـ refresh. ليه؟
غالبًا الـ message اتحطت في ViewBag/ViewData مع return View بعد POST (مفيش PRG)، فالـ refresh بيعيد الـ POST. الحل: TempData + Redirect؛ TempData بيتقري مرة واحدة ويتمسح.
08

أخطاء شائعة في MVC

Common mistakes
Basics
  • Binding مباشر لـ entity في POST action ← overposting.
  • نسيان antiforgery على forms بتعمل تغييرات (خصوصًا AJAX POST من غير header الـ token).
  • Business logic في الـ views أو الـ controllers بدل application services.
  • Return View بعد POST ناجح بدل Redirect ← double submit.
  • Html.Raw لمحتوى المستخدم ← XSS.
09

Knowledge Check

MVC essentials
Basics
هل Model في MVC لازم يكون EF entity؟
لا. الأفضل غالباً ViewModel مخصص للصفحة حتى لا تربط presentation بالـ persistence model.
هل Razor encoding يلغي كل مخاطر XSS؟
لا، لكنه يحمي text output المعتاد. السياقات الخاصة مثل JS/URL/HTML attributes تحتاج encoding مناسب، وتجنب Html.Raw للمدخلات غير الموثوقة.
متى أختار MVC Views؟
عندما تحتاج صفحات HTML rendered server-side ولا تحتاج فصل SPA/موبايل API كـ primary interface.
↗

المراجع والقراءة الإضافية

References & further reading

الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)

خريطة التغطية: 9 عنصر من الـ Roadmap ومكان شرحه في الدرس
RoadmapModel, View, and Controller§01
RoadmapRouting§02
RoadmapModel Binding§02
RoadmapValidation§02
RoadmapRazor Views§03
RoadmapDependency Injection§04
RoadmapFilters§04
RoadmapMVC vs Web API§01
RoadmapWhen MVC Is Appropriate§01

خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.

محتويات الدرس