C#如何使用IAsyncEnumerable C#异步流使用详解

IAsyncEnumerable是C# 8.0引入的异步流类型，适用于按需异步生成多个数据项的场景，支持await foreach消费、内存友好、可取消且响应及时。

IAsyncEnumerable 是 C# 8.0 引入的核心异步流类型，用于高效、自然地处理“按需异步生成的多个数据项”，比如分页查询、实时日志、流式 API 响应、大数据集逐块读取等场景。它不是一次性加载全部结果，而是支持 await foreach 消费，每个元素可独立 await，内存友好且响应及时。

什么时候该用 IAsyncEnumerable？

当你需要以下任意一种能力时，IAsyncEnumerable 是比 List 或 IEnumerable 更合适的选择：

• 数据源本身是异步的（如数据库分页查询、HTTP 流式响应、文件分块读取）
• 不想阻塞线程，也不愿把全部结果缓存在内存里（尤其数据量大或生成耗时）
• 消费者希望边接收边处理，而不是等所有数据就绪才开始（降低端到端延迟）
• 需要在迭代中途取消（配合 CancellationToken）

如何定义和返回 IAsyncEnumerable？

最常用方式是使用 async yield return 语法（需方法返回 IAsyncEnumerable，且标记为 async）：

示例：模拟异步分页获取用户

标签： 大数据 ai microsoft c# 内存占用