0

0

c# BlockingCollection.GetConsumingEnumerable 的用法

煙雲

煙雲

发布时间:2026-01-23 09:54:38

|

699人浏览过

|

来源于php中文网

原创

BlockingCollection.GetConsumingEnumerable 是一个线程安全的消费式枚举器,每次 MoveNext() 移除并返回一个元素,配合 CompleteAdding() 自动终止;不可超时、不可取消、不可重入,需用 foreach 安全遍历,异常需外层捕获。

c# blockingcollection.getconsumingenumerable 的用法

BlockingCollection.GetConsumingEnumerable 是什么

它不是普通迭代器,而是一个「消费式枚举器」:每次 MoveNext() 都会从 BlockingCollection移除并返回 一个元素;一旦集合被标记为完成添加(CompleteAdding())且内部为空,枚举就会自然结束。

它本质是为「生产者-消费者」场景设计的简化循环写法,替代手动调用 Take() 并捕获 InvalidOperationException 的繁琐逻辑。

怎么安全地用在多线程消费循环里
  • 必须搭配 CompleteAdding() 使用——否则枚举永远不会退出,即使集合已空,也会一直阻塞等待新元素
  • 不能在多个线程中同时调用同一个 GetConsumingEnumerable() 返回的枚举器(它不是线程安全的),但可以多个线程各自调用 GetConsumingEnumerable() 获取独立枚举器(每个都独占消费路径)
  • 推荐配合 foreach 使用,不要手动调用 GetEnumerator() + MoveNext(),避免意外跳过 Dispose 导致资源未释放
  • 如果消费逻辑可能抛异常,建议在 foreach 外层包 try/catch,否则异常会中断整个枚举,后续元素不再处理
var collection = new BlockingCollection();

// 启动消费者线程
Task.Run(() =>
{
    foreach (var item in collection.GetConsumingEnumerable())
    {
        Console.WriteLine($"处理: {item}");
        // 模拟耗时操作
        Thread.Sleep(100);
    }
    Console.WriteLine("消费者退出");
});

// 生产者:添加 3 个项,然后完成添加
collection.Add("A");
collection.Add("B");
collection.Add("C");
collection.CompleteAdding(); // ⚠️ 这行必不可少

和 Take()、TryTake() 的关键区别
  • Take():阻塞直到有元素或被取消,失败时抛 InvalidOperationException(如已 CompleteAdding() 且为空)
  • TryTake(out T, int):非阻塞或带超时,返回 bool 表示是否取到,适合需要控制等待时间的场景
  • GetConsumingEnumerable():隐式阻塞 + 自动判空 + 自动终止,语义更清晰,但**不可中断、不可超时、不可重入**

如果你需要超时、取消或多次复用同一集合做不同逻辑的消费,请别用 GetConsumingEnumerable(),改用 Take()TryTake() 配合循环。

VisualizeAI
VisualizeAI

用AI把你的想法变成现实

下载

容易踩的坑:CompleteAdding 调用时机 & 异常后状态
  • 忘了调用 CompleteAdding() → 消费者线程永久挂起,CPU 不占但线程卡死
  • 在生产者还没结束时就调了 CompleteAdding() → 后续 Add() 会立即抛 InvalidOperationException
  • 消费过程中抛未捕获异常 → 枚举器终止,但集合本身状态不变,其他正在调用 GetConsumingEnumerable() 的线程仍可继续消费剩余元素(只要没被 Complete)
  • BlockingCollection 被 dispose 后再调用 GetConsumingEnumerable() → 抛 ObjectDisposedException

最常被忽略的是:这个枚举器不响应 CancellationToken,也不能传入超时参数。真要支持取消,得自己包装一层,用 TryTake() 循环 + IsCancellationRequested 判断。

相关专题

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

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

67

2025.12.04

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

338

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

542

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

53

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

197

2025.08.29

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

482

2023.08.10

Python 多线程与异步编程实战
Python 多线程与异步编程实战

本专题系统讲解 Python 多线程与异步编程的核心概念与实战技巧,包括 threading 模块基础、线程同步机制、GIL 原理、asyncio 异步任务管理、协程与事件循环、任务调度与异常处理。通过实战示例,帮助学习者掌握 如何构建高性能、多任务并发的 Python 应用。

143

2025.12.24

java多线程相关教程合集
java多线程相关教程合集

本专题整合了java多线程相关教程,阅读专题下面的文章了解更多详细内容。

5

2026.01.21

C++ 高级模板编程与元编程
C++ 高级模板编程与元编程

本专题深入讲解 C++ 中的高级模板编程与元编程技术,涵盖模板特化、SFINAE、模板递归、类型萃取、编译时常量与计算、C++17 的折叠表达式与变长模板参数等。通过多个实际示例,帮助开发者掌握 如何利用 C++ 模板机制编写高效、可扩展的通用代码,并提升代码的灵活性与性能。

6

2026.01.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

光速学会docker容器
光速学会docker容器

共33课时 | 1.9万人学习

时间管理,自律给我自由
时间管理,自律给我自由

共5课时 | 0.8万人学习

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

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