.NET 8 Web开发入门（二）：C# 现代语法速成——为 Web API 量身定制

文章元信息

作者：刚子

系列名称：.NET 8 现代Web开发实战指南

原文链接：https://www.codeobservatory.cn/post/dotnet-8-web-development-part2-modern-csharp-for-webapi

关键词：C# 11, Record, 异步编程, async await, LINQ, 可空引用类型, Web API开发

摘要：本文专为Web开发者量身定制，深入浅出地讲解C#现代语法核心。重点解析Record类型在数据传输对象（DTO）中的应用、异步编程模型对高并发的意义、以及LINQ在数据处理中的优雅实践，助你快速掌握构建高效Web API的语法利器。

一、前言：从“能写”到“写得好”

在上一篇文章中，我们成功运行了第一个控制台程序。如果你有其他语言的基础，可能会觉得C#的语法有些似曾相识。但在现代.NET 8的Web开发中，我们极少使用传统的“类继承”或“繁琐的属性封装”，而是大量使用语法糖和新特性来降低代码量，提高安全性。

这一篇，我们将专注于三个核心领域：

数据载体：如何优雅地定义API的输入输出？
流程控制：如何处理耗时的数据库查询而不卡死服务器？
数据处理：如何像写SQL一样处理内存中的列表？

二、数据载体的革命：从 Class 到 Record

在Web API开发中，我们每天都在和“数据”打交道。前端发来JSON，我们解析成对象；数据库查出数据，我们封装成对象返回给前端。这些对象，通常被称为 DTO (Data Transfer Objects)。

2.1 传统 Class 的痛点

在旧时代，定义一个用户数据类通常是这样的：

public class UserDto
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }

    // 为了比较值是否相等，可能还需要重写 Equals 和 GetHashCode...
}

这太繁琐了。为了解决定义冗长、且容易被意外修改的问题，C# 9 引入了 Record（记录类型）。

2.2 使用 Record 定义不可变模型

在 Program.cs 中，你可以用一行代码定义一个强类型的模型：

public record User(int Id, string Name, string Email);

这就是全部。编译器会自动为你生成：

构造函数
只读属性（默认不可变，这对多线程环境非常安全）
Equals、GetHashCode 和 ToString 方法

实战演练： 让我们在一个控制台应用中测试 Record 的特性。

// 定义 Record
public record User(int Id, string Name, string Email);

class Program
{
    static void Main()
    {
        // 1. 构造对象
        var user1 = new User(1, "张三", "zhangsan@example.com");
        Console.WriteLine(user1); // 输出: User { Id = 1, Name = 张三, Email = zhangsan@example.com }

        // 2. 值相等性比较
        var user2 = new User(1, "张三", "zhangsan@example.com");
        // 即使是两个不同的对象实例，内容相同也被认为相等
        Console.WriteLine(user1 == user2); // 输出: True (这是 Class 做不到的)

        // 3. 不可变性与 with 表达式
        // user1.Name = "李四"; // 错误！Record 默认是只读的，无法直接修改
        
        // 如果需要修改，使用 with 创建一个副本
        var user3 = user1 with { Name = "李四" };
        Console.WriteLine(user3); // 输出: User { Id = 1, Name = 李四, Email = zhangsan@example.com }
    }
}

【架构师提示】 在Web API中，Record是定义DTO的首选。它的不可变性保证了数据在传递过程中不被意外篡改，且其内置的值比较逻辑让单元测试和状态判断变得异常简单。

【配图建议 1】 位置：Record代码示例之后。内容：分屏截图。左侧是传统Class的冗长代码，右侧是Record的单行代码。右侧标注“自动生成构造函数、属性、ToString”。 Alt文本：C# 传统Class定义与现代Record定义的代码量对比截图。

三、Web开发的生命线：异步编程 (Async/Await)

这是本篇最重要的章节。很多新手开发的网站在几个人访问时没问题，一旦并发量上来就卡死，原因往往是不懂异步编程。

3.1 为什么需要异步？

想象你在一家餐厅吃饭（服务器处理请求）。

同步模式：服务员下单后，站在厨房门口等菜做好，期间不服务其他客人。如果厨房慢，餐厅效率极低。
异步模式：服务员下单后，把单子给厨房，立即回去服务下一桌客人。等菜好了，厨房通知服务员端菜。

在Web开发中，“厨房”就是数据库、文件系统或外部API。如果使用同步代码访问数据库，服务器线程会被阻塞等待，资源被白白浪费。.NET通过 async 和 await 关键字优雅地解决了这个问题。

3.2 Task：未来的承诺

在.NET中，Task 或 Task 代表一个“正在进行”或“将来完成”的任务。

Task：代表一个没有返回值的异步操作（如写入文件）。
Task：代表一个将来会返回 T 类型结果的操作（如查询数据库）。

3.3 实战：模拟异步数据查询

我们通过模拟网络请求来体会异步的妙处。

using System;
using System.Diagnostics;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        Console.WriteLine("开始处理请求...");
        
        var stopwatch = Stopwatch.StartNew();
        
        // 模拟同时查询三个独立的数据源
        // 如果是同步，总耗时 = 1秒 + 2秒 + 3秒 = 6秒
        // 如果是异步并发，总耗时 ≈ Max(1, 2, 3) = 3秒
        
        Task<string> dbTask = GetDataFromDbAsync();     // 耗时1秒
        Task<string> apiTask = CallExternalApiAsync();  // 耗时2秒
        Task<string> fileTask = ReadFileAsync();        // 耗时3秒

        // await 会“暂停”当前函数的执行，但释放线程给其他请求使用
        // 当所有任务完成时，继续向下执行
        await Task.WhenAll(dbTask, apiTask, fileTask);
        
        Console.WriteLine($"数据1: {dbTask.Result}");
        Console.WriteLine($"数据2: {apiTask.Result}");
        Console.WriteLine($"数据3: {fileTask.Result}");
        
        stopwatch.Stop();
        Console.WriteLine($"总耗时: {stopwatch.ElapsedMilliseconds} ms");
    }

    // 模拟异步方法：关键字 async
    static async Task<string> GetDataFromDbAsync()
    {
        await Task.Delay(1000); // 模拟I/O等待
        return "数据库数据";
    }

    static async Task<string> CallExternalApiAsync()
    {
        await Task.Delay(2000);
        return "API响应数据";
    }

    static async Task<string> ReadFileAsync()
    {
        await Task.Delay(3000);
        return "文件内容";
    }
}

代码解析：

async 关键字：标记方法为异步方法，允许在内部使用 await。
await 关键字：这是核心。它告诉程序：“这里需要等待，你可以去处理别的事情，等结果出来了再回来继续执行下一行”。
Task.WhenAll：用于并发执行多个任务。在Web开发中，如果你需要查询三个不相关的数据源，并发查询能大幅提升接口响应速度。

【配图建议 2】 位置：异步编程实战代码之后。内容：时间轴示意图。

图A（同步）：线程1依次等待任务1、任务2、任务3，总时间长。

图B（异步）：线程1发起任务1、2、3后立即返回线程池服务其他请求，任务完成后线程1（或其他线程）继续处理结果。 Alt文本：同步阻塞与异步非阻塞处理流程的时间轴对比图。

四、数据处理的利器：LINQ

在Web后端，我们经常需要对列表数据进行筛选、排序或转换。传统的 foreach 循环代码量大且易出错。LINQ (Language Integrated Query) 提供了一种声明式的方式来处理数据。

4.1 方法语法 vs 查询语法

LINQ有两种写法，但在现代.NET开发中，方法语法配合Lambda表达式更为流行。

假设我们有一个订单列表：

public record Order(int Id, string Product, decimal Price, bool IsPaid);

4.2 常见操作实战

让我们看看在开发中如何使用LINQ。

using System;
using System.Collections.Generic;
using System.Linq; // 必须引入这个命名空间

class Program
{
    static void Main()
    {
        var orders = new List<Order>
        {
            new Order(1, "笔记本电脑", 8000, true),
            new Order(2, "鼠标", 50, false),
            new Order(3, "键盘", 200, true),
            new Order(4, "显示器", 1500, true),
            new Order(5, "耳机", 300, false)
        };

        // 需求1：查找所有已支付的订单
        var paidOrders = orders.Where(o => o.IsPaid);

        // 需求2：查找金额大于1000的订单，并按金额降序排列
        var expensiveOrders = orders
            .Where(o => o.Price > 1000)
            .OrderByDescending(o => o.Price);

        // 需求3：获取所有订单的产品名称列表 (投影)
        var productNames = orders.Select(o => o.Product).ToList();

        // 需求4：聚合计算 - 计算已支付订单的总金额
        var totalPaid = orders
            .Where(o => o.IsPaid)
            .Sum(o => o.Price);

        // 需求5：分页查询 (常见于Web API)
        // 跳过前2条，取接下来的2条
        var page2Data = orders.Skip(2).Take(2);

        // 打印结果
        Console.WriteLine($"已支付订单总金额: {totalPaid}");
        Console.WriteLine($"第二页数据: {string.Join(", ", page2Data.Select(o => o.Product))}");
    }
}

核心解析：

Where：过滤。相当于SQL的 WHERE。
Select：转换/投影。将 Order 对象转换为 String（产品名）或其他DTO。
OrderBy/OrderByDescending：排序。
Skip/Take：分页神器。Skip((pageNumber - 1) * pageSize).Take(pageSize) 是标准的分页写法。

【架构师提示】 LINQ不仅用于内存中的List，它也是Entity Framework Core（数据库ORM）的基础。当你对数据库使用LINQ时，.NET会自动将LINQ翻译成SQL语句。这意味着你学会了LINQ，就同时掌握了内存数据处理和数据库查询两大利器。

五、安全网：可空引用类型 (NRT)

最后，我们要谈谈“安全”。在Web开发中，最令人头疼的Bug莫过于 NullReferenceException（空引用异常）。

从.NET 6开始，项目默认开启了可空引用类型特性。这虽然叫“类型”，其实是编译器的一个警告机制。

5.1 传统 null 的隐患

string name = null;
Console.WriteLine(name.Length); // 运行时崩溃！报错俗称“未将对象引用设置到对象的实例”

5.2 现代 NRT 写法

在 csproj 文件中，你通常能看到 <Nullable>enable</Nullable>。开启后，编译器会强迫你思考：这个变量会不会为空？

string：非空字符串。编译器假设它永远不为null，如果你赋值null会报警告。
string?：可为空字符串。编译器知道它可能是null。

防御式编程示例：

void PrintLength(string? text)
{
    // 错误写法：编译器警告 text 可能是 null
    // Console.WriteLine(text.Length); 

    // 正确写法1：判空
    if (text != null)
    {
        Console.WriteLine(text.Length);
    }

    // 正确写法2：使用操作符 ?.
    // 如果 text 为 null，整个表达式返回 null，不会报错
    Console.WriteLine(text?.Length); 

    // 正确写法3：如果确定它一定不为空，使用 ! 操作符 (慎用)
    // 如果你违反规则传了null，仍会运行时报错
    // Console.WriteLine(text!.Length); 
}

对于新手，可能会觉得这些警告很烦。但请相信我，每一个警告都是在帮你消灭一个潜在的线上Bug。在Web API接收前端参数时，善用 string? 和 int? 可以帮你自动处理缺失字段的问题。

六、总结与下篇预告

在这篇3000字左右的文章中，我们完成了C#现代语法的突击特训。我们掌握了：

Record：定义简洁、不可变的数据模型。
Async/Await：避免线程阻塞，提升服务器并发能力。
LINQ：优雅地进行数据筛选、排序与分页。
NRT：利用编译器检查空引用，提升代码健壮性。

这四项技能，构成了Web API开发的“核心语法引擎”。

下一篇预告：虽然我们学会了语法，但代码都堆在 Program.cs 里显然不够专业。在第三篇文章中，我们将正式进入 ASP.NET Core Web API 的核心架构。我将带你解析 “依赖注入（DI）” 和 “中间件” 的奥秘。这是理解现代Web框架如何运转的关键一课，也是架构师思维转型的起点。

.NET 8 Web开发入门（二）：C# 现代语法速成——为 Web API 量身定制

一、前言：从“能写”到“写得好”

二、数据载体的革命：从 Class 到 Record

2.1 传统 Class 的痛点

2.2 使用 Record 定义不可变模型

三、Web开发的生命线：异步编程 (Async/Await)

3.1 为什么需要异步？

3.2 Task：未来的承诺

3.3 实战：模拟异步数据查询

四、数据处理的利器：LINQ

4.1 方法语法 vs 查询语法

4.2 常见操作实战

五、安全网：可空引用类型 (NRT)

5.1 传统 null 的隐患

5.2 现代 NRT 写法

六、总结与下篇预告

访客信息

关于博主

码农刚子

文章分类

标签云

最新文章

.NET 8 Web开发入门（二）：C# 现代语法速成——为 Web API 量身定制

一、前言：从“能写”到“写得好”

二、数据载体的革命：从 Class 到 Record

2.1 传统 Class 的痛点

2.2 使用 Record 定义不可变模型

三、Web开发的生命线：异步编程 (Async/Await)

3.1 为什么需要异步？

3.2 Task：未来的承诺

3.3 实战：模拟异步数据查询

四、数据处理的利器：LINQ

4.1 方法语法 vs 查询语法

4.2 常见操作实战

五、安全网：可空引用类型 (NRT)

5.1 传统 null 的隐患

5.2 现代 NRT 写法

六、总结与下篇预告

相关文章

.NET 8 Web开发入门（八）：交付时刻——Docker 容器化部署实战

.NET 8 Web开发入门（七）：安全门禁——JWT 身份验证与授权实战

访客信息

关于博主

码农刚子

文章分类

标签云

最新文章