MVC يعني إيه؟
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 كلها.
الـ 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.
Routing و Model Binding و Validation
[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 على المورد الحالي.
@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.
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 مباشرة.
[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 تفاصيلها للمستخدم.
Razor Views و HTML Rendering
View عادة في Views/{Controller}/{Action}.cshtml، و shared layout/partial views في مجلدات مشتركة. Razor يخلط HTML مع C# expressions باستخدام @. القيمة النصية تُعمل لها HTML encoding تلقائياً في المعتاد؛ تجنب Html.Raw مع input غير موثوق لأنه يفتح XSS.
@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 لها منطق/تحميل مستقل.
@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 آخر.
Dependency Injection و Filters في MVC
Controllers و Razor infrastructure تُنشأ عبر ASP.NET Core DI، لذا constructor injection هو النمط المعتاد. لا تنشئ database context داخل controller يدوياً. Filters تضيف behavior حول MVC actions/results؛ راجع درس Middleware للتمييز: middleware يشمل كل HTTP pipeline، بينما filters تخص MVC.
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 العام.
MVC vs Web API: تختار إيه؟
| Question | MVC with Views | Web API |
|---|---|---|
| Primary output | HTML pages | JSON/HTTP representations |
| Typical client | Browser navigation | SPA, mobile, services |
| Presentation | Server-side Razor | Usually client-side UI |
| Best fit | Content/site pages, server-rendered forms | Reusable 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.
مثال كامل: صفحة Edit في MVC بأمان
صفحة تعديل بيانات عميل هي أصغر مثال بيجمع كل مخاطر MVC: overposting، CSRF، validation، concurrency، و PRG. ده التنفيذ اللي تقدر تعتمد عليه كـ template.
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
}
}@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>| الخطر | الحماية في المثال |
|---|---|
| Overposting | ViewModel فيه الحقول المسموحة بس، مش الـ entity |
| CSRF | [ValidateAntiForgeryToken] + token من الـ form tag helper (أو AutoValidateAntiforgeryTokenAttribute globally) |
| Lost update | RowVersion في hidden field + DbUpdateConcurrencyException |
| Double submit | Post/Redirect/Get |
| IDOR | Authorization policy + tenant query filter؛ لو فيه ownership، resource-based authorization |
| XSS | Razor بيعمل HTML-encode تلقائي؛ تجنب Html.Raw مع بيانات المستخدم |
MVC/Razor Pages في 2026: إمتى لسه الاختيار الصح؟
مش كل واجهة محتاجة 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. ليه؟
أخطاء شائعة في MVC
- 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.
Knowledge Check
هل Model في MVC لازم يكون EF entity؟
هل Razor encoding يلغي كل مخاطر XSS؟
متى أختار MVC Views؟
المراجع والقراءة الإضافية
الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)
التوثيق الرسمي — Official documentation
خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.