Web开发入门(二):C# 现代语法速成——为 Web API 量身定制

📅 2026/6/26 6:30:58
Web开发入门(二):C# 现代语法速成——为 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, 张三, zhangsanexample.com); Console.WriteLine(user1); // 输出: User { Id 1, Name 张三, Email zhangsanexample.com } // 2. 值相等性比较 var user2 new User(1, 张三, zhangsanexample.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 zhangsanexample.com } } }【刚子提示】在Web API中Record是定义DTO的首选。它的不可变性保证了数据在传递过程中不被意外篡改且其内置的值比较逻辑让单元测试和状态判断变得异常简单。三、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秒 Taskstring dbTask GetDataFromDbAsync(); // 耗时1秒 Taskstring apiTask CallExternalApiAsync(); // 耗时2秒 Taskstring 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 Taskstring GetDataFromDbAsync() { await Task.Delay(1000); // 模拟I/O等待 return 数据库数据; } static async Taskstring CallExternalApiAsync() { await Task.Delay(2000); return API响应数据; } static async Taskstring ReadFileAsync() { await Task.Delay(3000); return 文件内容; } }代码解析async关键字标记方法为异步方法允许在内部使用await。await关键字这是核心。它告诉程序“这里需要等待你可以去处理别的事情等结果出来了再回来继续执行下一行”。Task.WhenAll用于并发执行多个任务。在Web开发中如果你需要查询三个不相关的数据源并发查询能大幅提升接口响应速度。四、数据处理的利器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 ListOrder { 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文件中你通常能看到Nullableenable/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 量身定制 - 码农刚子的开发笔记合集: .NET 8 现代Web开发实战指南标签: 异步编程, async await, LINQ, 可空引用类型, Web API开发免责声明本内容来自平台创作者博客园系信息发布平台仅提供信息存储空间服务。好文要顶 关注我 收藏该文 微信分享码农刚子粉丝 - 61 关注 - 11加关注10« 上一篇 2026个人博客建站指南这4种方案总有一款适合你» 下一篇 .NET 8 Web开发入门三解构引擎——依赖注入(DI)与中间件管道posted 2026-05-08 08:01 码农刚子 阅读(1380) 评论(7) 收藏 举报