关于Task.WhenEach生成的IAsyncEnumerable多次枚举异常行为的问询

1. 这是Task.WhenEach的预期行为吗？ #

是的，这属于预期行为。Task.WhenEach返回的IAsyncEnumerable<T>是一次性枚举的序列：第一次枚举时会遍历并完成所有关联的任务，当再次调用GetAsyncEnumerator时，内部已没有待处理的任务，因此会直接返回空序列，且不会抛出异常。

2. 该行为是否有官方文档说明？ #

官方文档明确指出，Task.WhenEach生成的异步序列仅支持单次枚举。IAsyncEnumerable<T>接口本身并未强制要求所有实现都支持多次枚举，仅保证单次枚举的正确性；是否支持多次枚举，完全由具体实现的设计决定。

关于“抛出异常而非返回空”的合理性 #

你提到的这个观点很合理：静默返回空的行为确实容易引发隐蔽的逻辑错误。对于不支持多次枚举的IAsyncEnumerable<T>实现，抛出InvalidOperationException（类似部分IEnumerable实现的处理方式）会更具警示性，但这属于具体实现的设计选择，并非接口强制要求。

类似案例：CsvReader的GetRecordsAsync #

CsvReader.GetRecordsAsync同样属于不支持多次枚举的实现。它依赖底层流的读取状态，第一次枚举会消耗流中的所有数据，再次枚举时流已处于末尾位置，因此也会返回空序列。这类基于“消耗型数据源”的异步序列，通常都仅支持单次枚举。

内容的提问来源于stack exchange，提问作者Jeppe Stig Nielsen