Skip to content

1. 引言

本文档的 PDF 在 这里。

本文档的代码在 这里。

本文档由 Anthropic 的 AI Claude 生成。它是针对 C# 14 和 .NET 10 平台,对 Serge Tahé 于 2008 年 5 月撰写的 课程 “使用 .NET 3.5 框架学习 C# 3.0 版”的重写。它保留了课程的大纲、示例和中心主线,同时更新了语言、库和工具:

  • 2008 年的课程使用的是 C# 3.0 和 .NET 3.5 框架,运行在 Windows 上,使用 Visual C# 2008 Express。此后,C# 已经发布了十一个主要版本(从 2010 年的 C# 4.0 到 2025 年的 C# 14),.NET 平台也被彻底重写:它现在是开源的、跨平台的(Windows、Linux、macOS),并且每年发布一次。本文档使用 .NET 10 (2025 年 11 月,长期支持版本)和 C# 14;
  • 关于 Windows Forms 图形用户界面的章节已被删除:如今,商业应用程序大多使用 Web 界面编写。其后的“用户事件”一章已改写为关于委托、lambda 表达式和事件的一章,不再涉及窗体;
  • 新增了两章:异步编程 ([Task] 任务以及 [async] / [await],于 2012 年随 C# 5 引入)和 Entity Framework Core(.NET 的对象关系映射工具)。关于常用 .NET 类的一章现在涵盖了 LINQ (2008 年的课程明确指出不涉及这部分内容);
  • 工具已经改变:[VS Code] 编辑器(或集成开发环境 [Visual Studio 2026])和 [dotnet] 命令取代了 Visual C# 2008 Express;[MSTest] 测试框架取代了 [NUnit 2];由 [Microsoft.Extensions.DependencyInjection] 提供的依赖注入取代了 [Spring.NET];数据库管理系统 [MySQL](由 [Laragon] 提供)和 [MySqlConnector] 连接器取代了 SQL Server 2005 Express;[HttpClient] 类取代了已被弃用的 [WebClient] 和 [WebRequest];使用 ASP.NET Core 编写的 REST / JSON Web 服务取代了 SOAP 和 [ASMX] Web 服务;
  • 所有已过时的内容都已被删除或标明为过时,每一章都会介绍撰写时语言和平台的最新特性。

本文档不是一份全面的课程。与 2008 年版一样,它面向已有编程经验、希望学习 C# 基础知识的读者。它以示例为主:两百多个程序(近三百个 C# 文件),大多数都很短,并带有逐行注释。

1.1. 2002 年至 2026 年的 C# 与 .NET

C# 于 2002 年 2 月随 Microsoft 的 .NET 1.0 平台一同发布,二者密不可分。.NET 平台是一种类似于 Java 虚拟机的运行时环境:.NET 语言(C#、F#、VB.NET)的编译器生成中间代码(IL,“Intermediate Language”,即中间语言),由 .NET 虚拟机(CLR,“Common Language Runtime”,即公共语言运行时)即时编译为机器码。平台上的所有类对所有 .NET 语言都可用。

2008 年的课程指出,.NET 只能在 Windows 上运行,Mono 项目使其可以在 Unix 和 Linux 上有限地使用。如今情况已发生了很大变化:

  • 2016 年:.NET Core 1.0。Microsoft 发布了 .NET 的一个新实现,它是开源的(MIT 许可证,代码可在 GitHub 上获取)并且是 跨平台的:Windows、Linux 和 macOS。旧的“.NET”框架(.NET Framework 4.x)仍然为遗留的 Windows 应用程序提供支持,但不再继续开发;
  • 2020 年:.NET 5。.NET Core 简称为“.NET”:一个适用于所有用途(控制台、Web、桌面、移动、云)的统一平台;
  • 自 2020 年起:每年 11 月发布一个新版本的 .NET。偶数版本(.NET 6、8、10)享有 长期支持 (LTS,三年);奇数版本(.NET 7、9)享有 标准支持 (STS:十八个月,从 .NET 9 起延长至两年)。每个 .NET 版本都会带来新版本的 C#;
  • 2025 年 11 月:.NET 10(LTS)和 C# 14,本文档使用的就是它们。.NET 10 的支持期持续到 2028 年 11 月。

2008 年的课程还指出,2002 年的 C# 在很大程度上是 Java 的翻版,两者之间很容易切换,但此后这两种语言各自形成了鲜明的特点。如今差距进一步拉大:在各个版本的演进中,C# 吸收了函数式语言的概念(lambda 表达式、LINQ、模式匹配、记录、不可变类型)、异步编程([async] / [await],JavaScript、Python 和 Rust 后来也采用了它),以及能在编译时检测空引用的类型系统。

下表概括了自 C# 3.0 以来语言的主要新特性,并指出了本文档中讨论这些特性的章节:

版本
年份
主要新特性
章节
C# 4.0
2010
命名参数和可选参数(C# 4 中同时出现的 [dynamic] 类型和泛型变体不在讲解范围内)
3
C# 5
2012
异步方法 [async] / [await]
9
C# 6
2015
插值字符串 [$"..."]、[nameof]、运算符 [?.]、异常过滤器 [when]、表达式体成员
3, 4
C# 7.0–7.3
2017–2018
元组与解构、[out var]、本地函数、模式匹配、二进制字面量和分隔符 [_]、参数 [in]
3, 4
C# 8
2019
可为 null 的引用类型、表达式 [switch]、索引 [^1]、和范围 [1..3]、[??=]、声明 [using]、默认接口方法、异步流 [await foreach]
3 至 9
C# 9
2020
顶级语句、[record]、属性 [init]、[new()] 目标类型推断、关系模式和逻辑模式
3, 4
C# 10
2021
[global using]、文件范围的命名空间、[record struct]、lambda 的自然类型
3, 4, 7
C# 11
2022
原始字符串 ["""]、成员 [required]、列表模式、抽象静态接口成员
3, 4, 5, 12
C# 12
2023
主构造函数、集合表达式 [1, 2, 3]、任意类型的别名、lambda 的默认参数
3–7
C# 13
2024
集合 [params]、类型 [System.Threading.Lock]
3, 8
C# 14
2025
扩展成员([extension] 块)、[field] 关键字、[a?.B = x] 条件赋值、用户定义的复合赋值运算符、无类型 lambda 参数修饰符
4, 7

在平台方面,新引入的特性包括:[dotnet] 命令和单文件应用程序(.NET 10)、[.slnx] 解决方案格式、LINQ、现代泛型集合、[System.Text.Json]、编译时生成的正则表达式、依赖注入、任务和并行库、通道 [Channel<T>]、[HttpClient]、ASP.NET Core 和 Entity Framework Core。

1.2. 文档内容

本文档包含以下章节:

  • 第 2 章:搭建开发环境(.NET 10 SDK、VS Code 或 Visual Studio;[dotnet] 命令);
  • 第 3 章:语言基础(类型、运算符、控制语句、异常、枚举、参数传递、元组);
  • 第 4 章:类、结构、接口、继承、泛型、记录、扩展成员;
  • 第 5 章:常用的 .NET 类:字符串、数组、集合、LINQ、文本文件和二进制文件、JSON、正则表达式;
  • 第 6 章:分层架构、使用 MSTest 的单元测试和依赖注入;
  • 第 7 章:委托、lambda 表达式和事件;
  • 第 8 章:执行线程与同步;
  • 第 9 章:异步编程;
  • 第 10 章:使用 ADO.NET 访问数据库;
  • 第 11 章:Entity Framework Core;
  • 第 12 章:Web 编程(TCP/IP、TCP 客户端和服务器、使用 [HttpClient] 的 HTTP);
  • 第 13 章:使用 ASP.NET Core 的 Web 服务;
  • 第 14 章:进阶;
  • 附录:安装 Laragon 和 MySQL。

1.3. 主线:税款计算

与 2008 年一样,整个文档会反复回到同一个问题:计算只有工资收入需要申报的纳税人的所得税。所使用的税率表是原课程中的税率表(2003 年的收入):它已不再是现行税率,但对我们的目的而言已经足够,我们的目的就是用多种不同的方式编写同一个应用程序。它以九个版本实现:

版本
章节
内容
1
3
单个程序:经过验证的输入、计算、显示
2
4
类和接口:[TaxBracket], [ITax], [AbstractTax], [HardwiredTax]
3
5
从文本文件或 JSON 文件中读取计算数据
4
6
单个项目内的分层架构([dao]、[business]、[ui])
5
6
每层一个库、单元测试,以及通过依赖注入集成各层
6
10
使用 ADO.NET 从 MySQL 数据库中读取数据的 [dao] 层
7
11
使用 Entity Framework Core 编写的 [dao] 层
8
12
TCP 税款计算服务器及其客户端
9
13
税款计算的 REST Web 服务、控制台客户端和 Web 客户端

从版本 5 开始,后续版本 复用 版本 5 的各层,只替换发生变化的那一层:这正是第 6 章介绍的分层架构的意义所在。

1.4. 示例

本文档中的代码组织在一个名为 [csharp-oct-2026] 的文件夹中,每章一个子文件夹:

csharp-oct-2026/
├── 02-installation/       first programs, solution
├── 03-basics/             basics-01.cs to basics-28.cs, tax-v1.cs
├── 04-classes/            classes-01.cs to classes-25.cs, projects, TaxV2
├── 05-classes-dotnet/     strings, collections, LINQ, files, regex, TaxV3
├── 06-architectures/      TaxV4, TaxV5 (layers, tests, dependency injection)
├── 07-delegates/          delegates-01.cs to delegates-10.cs
├── 08-threads/            threads-01.cs to threads-24.cs
├── 09-async/              async-01.cs to async-23.cs
├── 10-adonet/             adonet-01.cs to adonet-09.cs, SQL scripts, TaxV6
├── 11-efcore/             EF Core projects, TaxV7
├── 12-internet/           internet-01.cs to internet-19.cs, TaxV8
└── 13-web-services/       ASP.NET Core web services and their clients (WsTax, ClientWsTax: version 9)

小程序都是 单文件应用程序:即一个扩展名为 [.cs] 的单个文件,通过命令 [dotnet run file.cs] 运行(第 2 章)。多文件程序则是按章节归入一个 解决方案 ([.slnx])的 项目 ([.csproj])。

本文档中的所有程序都使用 .NET 10 SDK 编译,没有错误和警告,随后都执行过。文档中重现的结果就来自这些执行。第 3 章的结果是在法语区域设置(fr-FR)下获得的,就像在法国的 Windows 工作站上一样:实数使用小数逗号显示,日期为法语格式。后面的章节是在美国英语区域设置(en-US)下运行的:小数点、以逗号作为千位分隔符、日期为月/日/年格式。两点说明:

  • .NET 平台的错误消息(异常消息)是英文的:.NET 没有为这些消息提供法语翻译;
  • 示例是在 Linux 上运行的。在大多数情况下这没有区别:.NET 是跨平台的。少数差异(使用 / 而非 \ 的文件路径、行尾符)会在出现处加以说明。

多线程、异步或网络程序的结果以及测得的执行时间,每次运行都可能有所不同:注释关注的是可复现的内容。

1.5. 参考资料

2008 年的课程列出了对撰写帮助很大的书籍:“Professional C# Programming”(Wrox)、Gérard Leblanc 的“C# et .NET”(Eyrolles),以及 Joseph 和 Ben Albahari 的“C# 3.0 in a Nutshell”(O’Reilly),“我读过的最好的编程书之一”。对于 2026 年版,主要参考资料是: