用途
本技能用于使用 ASP.NET Core MVC 构建服务端渲染的 Web 应用,重点覆盖 Razor 视图、ViewModel、ModelState 验证、Tag Helpers、View Components 与 Areas。触发场景包括:处理 .cshtml Razor 视图、_Layout.cshtml、局部视图;控制器返回 View()、PartialView()、RedirectToAction()(而非 Ok()/Json());ModelState 验证、模型绑定与 ViewModel 设计;Tag Helpers、View Components、HTML Helpers;Areas、路由模板与 MVC 特性路由;从旧版 ASP.NET MVC 5 迁移到 ASP.NET Core MVC;以及在 MVC、Razor Pages、Blazor 或 API 之间做选择。
技术选型
- 服务端渲染页面、多 action 控制器、复杂路由:MVC
- 以页面为中心、简单 CRUD、较少仪式感:Razor Pages
- 交互式 UI、实时更新、纯 .NET 技术栈:Blazor
- 为 SPA/移动端提供纯 JSON API:web-api 或 minimal-apis
判断依据:仓库中已有 Views/ 加 Controllers 则为 MVC;已有 Pages/ 加 .cshtml.cs PageModel 则为 Razor Pages。不要在同一功能中混用两种模式。
初始配置
在 Program.cs 中通过 AddControllersWithViews() 注册服务,可附加 AddRazorRuntimeCompilation()(仅开发环境,用于自动重载 .cshtml);使用 UseStaticFiles、UseRouting、UseAuthentication、UseAuthorization,并通过 MapControllerRoute 定义默认路由 {controller=Home}/{action=Index}/{id?}。
控制器模式
应为每个视图建立独立的 View Model,不直接使用实体。示例中 ProductEditVm 为 record,包含 Id、Name、Price 与分类下拉列表;GET 时查询实体并映射为 ViewModel 返回视图;POST 时先检查 ModelState.IsValid,再查询并更新实体,最后以 TempData 传递成功消息并调用 RedirectToAction 执行 PRG 模式,避免刷新重复提交。
验证
使用 DataAnnotations,例如 [Required, StringLength(200)]、[Range(0.01, 1_000_000)],POST 时先检查 ModelState,再做自定义校验(如名称重复时通过 ModelState.AddModelError 添加错误并返回视图)。
Razor 视图模式
推荐 Tag Helpers 替代 HTML Helpers,例如使用 label asp-for、input asp-for、span asp-validation-for。Layout 中通过 @RenderBody 与 RenderSectionAsync 渲染内容与脚本、样式区段。局部视图使用异步的 <partial name="..." model="..." />。当组件需要自行取数时(如购物车摘要、侧边栏菜单),使用 View Component 而非 ViewBag,其视图放在 Views/Shared/Components/CartSummary/Default.cshtml,调用方式为 <vc:cart-summary />。Display/Editor Templates 可为特定类型提供统一渲染,如 DisplayTemplates/Money.cshtml。
路由与 Areas
约定式路由适合传统 CRUD 应用;特性路由更精确,适合 REST 与 SEO 友好的 URL,例如 [Route("san-pham")]、[Route("{id:int}")]、[Route("danh-muc/{slug}")]。Areas 用于模块划分,如 Admin 区域,并通过 MapAreaControllerRoute 注册,配合 [Area("Admin"), Authorize(Roles = "Admin")]。
数据传递方式
Model 为强类型、按视图生命周期,默认用于控制器与视图之间传递数据。ViewData["X"] 为单次请求内的 object,适合标题、侧边栏等辅助数据。ViewBag.X 为 dynamic,不推荐(无 IntelliSense)。TempData["X"] 跨一次重定向,适合 PRG 的提示消息。
反模式与修复
- 直接返回数据库实体到视图:导致懒加载、过度提交、泄露 schema,应改用 View Model。
- 视图中写大量逻辑:难以测试,应移到控制器或 View Component。
- 滥用 ViewBag:无 IntelliSense 且易运行时出错,应使用强类型 Model。
- POST 成功后 return View():刷新会重复提交,应使用 PRG 的 RedirectToAction。
- POST 缺少 [ValidateAntiForgeryToken]:存在 CSRF 风险,应添加该特性。
- 臃肿控制器(超过 5 个 action 或 300 行):难以维护,应拆分 Service 层或引入 Mediator。
- 同步 I/O:阻塞线程,应使用 await ToListAsync()。
- 对 HTML 表单使用 [FromBody]:表单为 form-encoded 而非 JSON,应去掉该特性以走默认模型绑定。
检查清单要点
每个视图使用独立 View Model;POST 后检查 ModelState 并 PRG 重定向;所有 POST 添加防伪令牌;用 Tag Helpers 替代 HTML Helpers;用 Layout 与 Sections 管理脚本、样式;需要取数的组件使用 View Component;全链路 async/await;存在独立 Admin 或 Customer 模块时使用 Areas。
移交方向
为 SPA/移动端提供 JSON API 时转向 web-api 或 minimal-apis;实时 UI(聊天、通知)转 Blazor 或 SignalR;ORM 相关问题转向 entity-framework-core;认证转 aspnet-core(JWT 或 Cookie)。