0

0

c# 在 IAsyncEnumerable 中使用 yield break

煙雲

煙雲

发布时间:2026-01-04 11:49:02

|

234人浏览过

|

来源于php中文网

原创

合法,但仅限于异步迭代器方法;yield break 立即终止迭代,return 表示自然结束;需配合 yield return 使用,不可用于普通 async Task 方法。

c# 在 iasyncenumerable 中使用 yield break

yield break 在 IAsyncEnumerable 方法中是否合法

合法,但仅限于异步迭代器方法(即返回 IAsyncEnumerable 且标记为 async 的方法),且必须配合 yield return 使用。直接在普通 async Task 方法里写 yield break 会编译失败 —— 编译器会报错 CS1625: Cannot yield a value in the body of a method that does not have a return type of 'IEnumerable', 'IEnumerator', 'IAsyncEnumerable', or 'IAsyncEnumerator'

什么时候该用 yield break 而不是 return

IAsyncEnumerable 方法中,yield break 表示“立即终止迭代,不产出任何后续项”,而 return(无值)表示“迭代完成,已产出所有项”。二者语义不同:

  • yield break:迭代器立刻退出,调用方的 await foreach 会直接结束,不会触发 MoveNextAsync() 后续调用
  • return:当前迭代项产出完毕后正常退出,适用于“自然结束”场景

典型使用场景是条件提前终止:

public async IAsyncEnumerable GetLinesAsync(string path)
{
    await foreach (var line in File.ReadLinesAsync(path))
    {
        if (line.StartsWith("#")) continue;
        if (line.Trim() == "") yield break; // 遇到空行就停,不读后面
        yield return line;
    }
}

yield break 和异常处理的交互

yield break 是正常控制流,不会触发 DisposeAsync() 中的异常传播逻辑,但会影响 await foreach 的完成状态:

千博购物系统.Net
千博购物系统.Net

千博购物系统.Net能够适合不同类型商品,为您提供了一个完整的在线开店解决方案。千博购物系统.Net除了拥有一般网上商店系统所具有的所有功能,还拥有着其它网店系统没有的许多超强功能。千博购物系统.Net适合中小企业和个人快速构建个性化的网上商店。强劲、安全、稳定、易用、免费是它的主要特性。系统由C#及Access/MS SQL开发,是B/S(浏览器/服务器)结构Asp.Net程序。多种独创的技术使

下载
  • 如果在 try 块中 yield break,对应的 finally 仍会执行(因为这是迭代器状态机的正常退出路径)
  • 若在 yield return 后、下一次 MoveNextAsync() 前抛出异常,则 yield break 不会被执行,也不会“覆盖”异常
  • yield break 不会取消底层 CancellationToken,它只是退出迭代器函数体

常见误判:以为 yield break 能中断正在运行的异步操作(比如一个未完成的 await Task.Delay(5000))。实际不能 —— 必须显式检查 cancellationToken.IsCancellationRequestedthrow new OperationCanceledException()

性能与状态机开销需要注意的地方

每次 yield break 都会让编译器生成的状态机进入 Completed 状态,这本身开销极小。但容易被忽略的是:如果 yield break 出现在高频路径(如每轮循环都可能触发),而你本意是跳过单次迭代,那应该用 continue 而不是 yield break —— 后者会彻底终结整个序列。

另一个隐藏成本:若在 yield break 前刚 await 过一个未完成的 Task(比如数据库查询),该 Task 仍在运行,但你已放弃等待结果。此时没有自动取消机制,可能造成资源泄漏或后台任务滞留。

相关专题

更多
php中foreach用法
php中foreach用法

本专题整合了php中foreach用法的相关介绍,阅读专题下面的文章了解更多详细教程。

41

2025.12.04

java中break的作用
java中break的作用

本专题整合了java中break的用法教程,阅读专题下面的文章了解更多详细内容。

116

2025.10.15

java break和continue
java break和continue

本专题整合了java break和continue的区别相关内容,阅读专题下面的文章了解更多详细内容。

255

2025.10.24

java break和continue
java break和continue

本专题整合了java break和continue的区别相关内容,阅读专题下面的文章了解更多详细内容。

255

2025.10.24

数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

340

2023.06.29

如何删除数据库
如何删除数据库

删除数据库是指在MySQL中完全移除一个数据库及其所包含的所有数据和结构,作用包括:1、释放存储空间;2、确保数据的安全性;3、提高数据库的整体性能,加速查询和操作的执行速度。尽管删除数据库具有一些好处,但在执行任何删除操作之前,务必谨慎操作,并备份重要的数据。删除数据库将永久性地删除所有相关数据和结构,无法回滚。

2072

2023.08.14

vb怎么连接数据库
vb怎么连接数据库

在VB中,连接数据库通常使用ADO(ActiveX 数据对象)或 DAO(Data Access Objects)这两个技术来实现:1、引入ADO库;2、创建ADO连接对象;3、配置连接字符串;4、打开连接;5、执行SQL语句;6、处理查询结果;7、关闭连接即可。

346

2023.08.31

MySQL恢复数据库
MySQL恢复数据库

MySQL恢复数据库的方法有使用物理备份恢复、使用逻辑备份恢复、使用二进制日志恢复和使用数据库复制进行恢复等。本专题为大家提供MySQL数据库相关的文章、下载、课程内容,供大家免费下载体验。

253

2023.09.05

java学习网站推荐汇总
java学习网站推荐汇总

本专题整合了java学习网站相关内容,阅读专题下面的文章了解更多详细内容。

6

2026.01.08

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
10分钟--Midjourney创作自己的漫画
10分钟--Midjourney创作自己的漫画

共1课时 | 0.1万人学习

Midjourney 关键词系列整合
Midjourney 关键词系列整合

共13课时 | 0.9万人学习

AI绘画教程
AI绘画教程

共2课时 | 0.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号