Skip to content

1. 简介

本文档的 PDF 版本在 |这里|。

本文档的代码在 |这里|。

本文档由 Anthropic 的 AI Claude 创作。它承接文档 “[NestJS] Web 框架分步入门”(2026 年),后者又将文档 “通过示例学习 ASP.NET MVC”(2013 年)改编到了 [NestJS] 框架上。本文档走的是相反的道路,回到 [.NET] 平台的当前版本:

  • [NestJS] 框架和 [TypeScript] 语言被 [ASP.NET Core MVC] 框架和 [C#] 语言取代;
  • [Handlebars] 视图被 [Razor] 视图取代;
  • ORM 和 [TypeORM] 被 ORM 和 [Entity Framework Core] 取代,底层仍然使用 [MySQL]。

本文档紧密遵循 [NestJS] 课程的进度:先是许多小项目,每个项目只聚焦一个概念,随后是一个完整的案例研究——一个用于安排医疗诊所预约的 Web 应用程序——所有文件都附有完整注释。这些示例的编号和主题与 [NestJS] 课程相同:熟悉该课程的读者可以逐个示例地比较这两个框架。不过这并非必需:本文档自成一体,不要求读者事先了解 [NestJS],对 [ASP.NET] 也同样如此。仅有的先决条件是对 Web 编程(HTTP 协议、HTML 语言)的基本了解,以及 [C#] 语言。

1.1. ASP.NET Core MVC 在 Web 应用程序中的作用

Web 应用程序通常采用分层构建,每一层只与相邻的层通信:

Image

  • Web 层接收来自浏览器的 HTTP 请求,并向其返回 HTML 页面。这一层正是 [ASP.NET Core MVC] 帮助我们编写的部分;
  • 业务层包含应用程序的业务规则(例如“一名患者只能有一个即将到来的预约”)。它对 Web 一无所知:它同样可以为命令行应用程序提供服务;
  • 数据访问层([DAO] 层,即 [Data Access Object])负责读写数据库。我们将使用 ORM [Entity Framework Core] ([Object Relational Mapper]),它在表的行与 [C#] 对象之间建立映射。

Web 层本身遵循 [MVC] ([Model – View – Controller])模式:

  • 控制器(C)是一个类,它的方法——称为 操作(action)——各自处理特定类型的请求(例如 [GET /schedule])。操作读取请求参数,调用业务层,然后选择要显示的视图;
  • 模型(M)是操作传递给视图的数据集合:一个 [C#] 对象;
  • 视图(V)是一个 [Razor] 文件(扩展名为 [.cshtml]):它由 HTML 构成,其中 [C#] 表达式——前面带有 [@]——会被模型中的数据替换。

请求的处理过程遵循图中的编号步骤:

  • 1:浏览器发送一个 HTTP 请求,例如 [GET /schedule?doctorId=1&day=2026-09-24];
  • 2:Web 服务器 [Kestrel] 与 [ASP.NET Core] 集成,接收请求。请求先经过一系列 中间件组件 (读取 Cookie、身份验证、静态文件等),然后 [ASP.NET Core] 选择负责处理该请求的操作:这就是 路由。在到达操作之前,请求还可能经过 过滤器,我们将在后面的章节中探讨;
  • 3:操作向业务层请求所需的数据;
  • 4:它构造视图模板,并指定应显示该模板的视图;
  • 5:[Razor] 视图引擎渲染 HTML 页面,[ASP.NET Core] 再将其返回给浏览器。

[ASP.NET Core] 是微软 [.NET] 平台的 Web 框架。它免费且开源,可运行于 [Windows]、[Linux]、和 [macOS]。它既可以创建向 [JavaScript] 客户端([Angular]、[React]、[Flutter]……)返回 JSON 的服务器,也可以创建传统的 Web 应用程序,即由服务器生成 HTML 页面、浏览器只负责显示。本文档考察的正是第二种用法——框架中的 MVC 部分。与大量借鉴了它的 [NestJS] 一样,[ASP.NET Core] 建立在两个理念之上:特性(attribute)([[HttpGet]]、[[Route]]、[[Authorize]]……)描述类和方法的角色,而 依赖注入 为每个对象提供其所需的依赖项。

1.2. 使用的工具

示例使用以下工具编写和测试(其安装方法见附录):

  • [.NET] 10 SDK([Software Development Kit]),其中包含 [C#] 编译器、[ASP.NET Core] 框架以及 [dotnet] 命令行工具。[.NET] 10 是当前的 LTS(长期支持)版本;
  • [Visual Studio Code] 编辑器,以及 [C# Dev Kit] 扩展;
  • 较新的浏览器([Chrome]、[Firefox]、[Edge]);
  • 命令行工具 [curl],它显示原始的 HTTP 响应([Windows] 10 和 11 已自带);
  • 数据库管理系统 [MySQL] (或 [MariaDB]),例如 [Laragon] 在 [Windows] 下附带的那个,从数据访问一章开始以及案例研究中使用。

[ASP.NET Core] 框架是 SDK 的一部分:直到第 8 章,示例都不需要任何额外的库。示例 25 至 28 以及案例研究使用三个库,它们会在首次编译时自动从 [nuget.org] 网站下载(因此当天必须连接互联网):[Microsoft.AspNetCore.Authentication.JwtBearer] (JWT 令牌)、[BCrypt.Net-Next] (密码哈希)和 [Pomelo.EntityFrameworkCore.MySql] (适用于 [Entity Framework Core] 与 [MySQL] 配合使用)。

1.3. 运行案例研究

审阅者注:我建议读者按照下面的说明立即运行案例研究。当你完全理解了这个预约管理应用程序的作用之后,请让你最喜欢的 AI 按如下方式修改该应用程序:今后,每位医生都可以:

  • 在两个日期之间设置自己的预约时段。这样他们就可以根据需要调整自己的日程;
  • 在某一天从日历中移除某些时间段——例如,当他们因个人原因无法出诊时;

这项修改并不简单,因为它涉及数据库结构的变更。请让 AI 给你提供新的应用程序代码以及用于创建新数据库的 SQL 脚本。为此,你需要把包含完整项目的 ZIP 文件以及旧数据库的 SQL 脚本提供给它。

另外,我没有审阅过由 Claude 创作的这门课程。他之前已经制作出了完美的 [NestJS] 课程,我就假定这一门也是如此。如果你在理解某些内容时遇到问题,解决办法始终是一样的:让你最喜欢的 AI 解释你不理解的地方。例如 Claude 就非常擅长这件事。你可能需要把不理解的示例“上传”给它。

注释结束。

本文档末尾的案例研究是一个完整的应用程序。读者很可能希望在深入框架细节之前先看到它运行起来:下面介绍运行方法。它位于 [rdvmedecins2-aspnetcore-mvc] 文件夹中,与 [examples] 文件夹并列:

1
2
3
aspnetcore-mvc-sept-2026/
├── examples/
└── rdvmedecins2-aspnetcore-mvc/

你必须已安装 SDK、[.NET] 10、[Visual Studio Code] 和 [MySQL] (见附录)。然后:

  • 通过运行 [dbrdvmedecins2] 脚本 来创建数据库 [rdvmedecins2-aspnetcore-mvc/database/dbrdvmedecins2.sql]。使用 [Laragon] 时,打开 [HeidiSQL] 工具(Database 按钮),然后通过 File / Run SQL 菜单运行该脚本。在命令行中:
mysql -u root < database/dbrdvmedecins2.sql
  • 检查数据库连接。应用程序连接到 [MySQL] 所在的 [localhost],端口 3306,使用用户 [root] 且无密码 (这是 [Laragon] 的默认设置)。如果你的 [root] 账户有密码,请在应用程序的 [appsettings.json] 文件中,将其填写在 [ConnectionStrings:RdvMedecins] 连接字符串的末尾([...;User=root;Password=myPassword;])。对于 [MariaDB],还要在 [MySql:ServerVersion] 键中指定其版本(例如 [10.11.0-mariadb]);
  • 在 [Visual Studio Code] 中打开 [rdvmedecins2-aspnetcore-mvc] 文件夹 (File 菜单 / Open Folder),然后打开终端(Terminal 菜单 / New Terminal);
  • 启动应用程序:
dotnet run
  • 首次运行时,[dotnet] 会从 [nuget.org] 下载库、编译应用程序,然后启动它。控制台随后显示应用程序的地址:
Using launch settings from Properties/launchSettings.json...
Building...
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:8081
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:\course\rdvmedecins2-aspnetcore-mvc
  • 在浏览器中打开地址 [http://localhost:8081] :

Image

  • 使用其中一个演示账户登录,其密码与用户名相同:[admin] (管理员)、[pelissier]、[tatou]、[dupont] (医生)、[martin]、[durand]、[bistrou]、[german] (患者)。你还必须输入图片中的字符,大小写均可。

如果应用程序立即关闭并显示消息 [Unable to connect to any of the specified MySQL hosts],说明 [MySQL] 尚未启动;如果显示 [Access denied for user 'root'@'localhost'],说明连接字符串中的密码不正确;如果显示 [Unknown database 'dbrdvmedecins2'],说明 SQL 脚本尚未执行。应用程序的 [README.md] 文件描述了其他情形。在终端中使用 [Ctrl-C] 停止应用程序。

文档的最后一章说明如何使用该应用程序,然后逐一讨论它的每个文件。

1.4. 示例

示例存放在 [examples] 文件夹中,每个示例对应一个子文件夹:

1
2
3
4
5
6
7
8
9
examples/
├── 01-structure/
├── 02-routing/
├── ...
├── 28-layers/
├── common/
│   └── bootstrap/
├── Directory.Build.props
└── examples.slnx

每个示例都是一个独立的 [.NET] 项目,可以单独编译和运行。文件 [examples.slnx] 是一个 解决方案:即所有这些项目的列表。在 [examples] 文件夹于 [Visual Studio Code] 中打开时,[C# Dev Kit] 扩展会找到该解决方案并加载所有项目(Solution Explorer 窗格):这样你就可以在每个文件中使用语法高亮、代码补全和错误提示。

[common/bootstrap] 文件夹包含 CSS 和 [Bootstrap] 框架,由需要设置页面样式的示例共享(从示例 15 开始)。

每个示例都具有 [ASP.NET Core MVC] 项目的结构:

13-first-view/
├── Controllers/
│   └── ViewsController.cs
├── Models/
│   └── PageModel.cs
├── Views/
│   ├── Views/
│   │   ├── Index.cshtml
│   │   └── Unknown.cshtml
│   └── _ViewImports.cshtml
├── appsettings.json
├── Example13.csproj
└── Program.cs
  • [Program.cs]:应用程序的入口点——配置、服务和服务器启动;
  • [Controllers]:控制器;
  • [Models]:描述模型的类(用于操作和视图);
  • [Views]:[Razor] 视图(从第 4 章开始);
  • [appsettings.json]:应用程序配置(日志级别,以及后面的数据库连接等);
  • [Example13.csproj]:项目文件,描述如何编译应用程序。

要运行示例,请在其文件夹中打开终端(在 [Visual Studio Code] 中:右键单击示例文件夹,然后选择“在内置终端中打开”),并输入:

dotnet run

[dotnet run] 编译项目(输出到其 [bin] 文件夹),然后运行应用程序。使用 [dotnet watch] 时,每当修改 [.cs] 或 [.cshtml] 文件,代码就会重新编译,应用程序也会重新启动:

dotnet watch

所有示例都监听 5000 端口,这是 [ASP.NET Core] 的默认端口:同一时间只能运行一个示例。在终端中使用 [Ctrl-C] 停止服务器。你还可以在 [examples] 文件夹中一次性编译所有示例,以验证安装是否完整:

dotnet build examples.slnx

示例的项目文件精简到只有一行。例如 [01-structure/Example01.csproj]:

<Project Sdk="Microsoft.NET.Sdk.Web">
</Project>
  • 第 1 行:[Microsoft.NET.Sdk.Web] 是 Web 应用程序的 SDK。仅凭它就提供了完整的 [ASP.NET Core] 框架:控制器、视图、配置、Web 服务器……

所有示例共有的设置只写一次,位于 [examples/Directory.Build.props] 文件中,编译器会为位于 [examples] 文件夹中的任何项目自动读取该文件:

<!--
  Directory.Build.props: read automatically by ALL the projects located
  under this folder. The settings shared by the examples are therefore written
  only once, here, instead of being repeated in every .csproj file.
-->
<Project>
  <PropertyGroup>
    <!-- .NET 10,LTS 版本(长期支持) -->
    <TargetFramework>net10.0</TargetFramework>
    <!-- 编译器会报告 NullReferenceException 的风险 -->
    <Nullable>enable</Nullable>
    <!-- 隐式 using:System、System.Linq、System.Threading.Tasks…… -->
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>
</Project>

我们来逐项讲解这个文件:

  • 第 9 行:[.NET] 的目标版本:[.NET] 10;
  • 第 11 行:“可为 null”的引用类型。编译器会区分 [string] 类型的变量(绝不能赋值为 [null])和 [string?] 类型的变量(可以赋值为 null),并对任何可能引发 [NullReferenceException] 的潜在错误发出警告;
  • 第 13 行:最常用的命名空间([System]、[System.Linq]、[System.Threading.Tasks]、[Microsoft.AspNetCore.Builder]……)会自动导入到每个文件中:无需编写相应的 [using] 指令。

最后,直到第 8 章,所有示例的 [appsettings.json] 文件都是相同的:

1
2
3
4
5
6
7
8
9
{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*"
}
  • 第 4–5 行:日志级别。应用程序的消息从 [Information] 级别开始显示;而 来自 [ASP.NET Core] 自身的消息——数量非常多——只从 [Warning] 级别开始显示。因此,控制台会显示启动消息和错误,但不会显示每个请求的细节;
  • 第 8 行:请求中接受的域名([*]:全部)。

1.5. 文档内容

本文档的组织结构如下:

章节
内容
示例
控制器、操作、
从浏览器到操作:路由、响应、重定向、服务
01 至 06
操作模型
请求参数:绑定、转换、验证、POST 表单
07 至 12
视图及其模型
Razor、模板、分部视图、辅助方法、表单、验证、PRG
13 至 21
国际化
法语和英语双语应用程序
22
数据作用域
应用程序、请求、客户端
23
请求的生命周期
中间件、授权过滤器、操作过滤器、异常过滤器、模型绑定
24
身份验证与授权
Cookie 中的 JWT、角色、验证码、尝试次数限制
25–27
分层架构
基于 Entity Framework Core 和 MySQL 的 Web / 业务 / DAO
28
案例研究
RdvMedecins 应用程序,逐个文件讲解
-

每个示例只引入少量新概念,各章环环相扣:最好按顺序阅读。而案例研究则运用了 所有 前面各章的概念:在相关之处,其讲解会指向该概念首次引入的示例。