<p>yield关键字用于简化迭代器实现，通过yield return返回元素并暂停执行，下次继续，而yield break可提前终止迭代；它适用于返回IEnumerable或IEnumerator的方法，实现惰性求值，如生成序列、过滤数据等，且编译器会将其转换为状态机，注意不能在C# 7及更早版本的匿名或async方法中使用。</p>

yield 关键字是 C# 中用于简化迭代器实现的一个语言特性。它允许你创建一个可以按需返回元素的枚举逻辑，而无需手动实现 IEnumerable 或 IEnumerator 接口。

当你使用 yield return 时，每次迭代到该语句时，会返回一个值，并保留当前执行位置，下次继续从该位置往后执行。当遇到 yield break 时，迭代将提前终止。

yield 的基本用法

方法、属性或运算符的返回类型为 IEnumerable、IEnumerable<T>、IEnumerator 或 IEnumerator<T> 时，就可以使用 yield 来构建自定义迭代逻辑。

public IEnumerable CountUpTo(int max) { int current = 1; while (current <= max) { yield return current; current++; } }

调用这个方法：

foreach (int number in CountUpTo(5)) { Console.WriteLine(number); // 输出 1, 2, 3, 4, 5 }

这段代码不会一次性生成所有值，而是每次循环请求下一个值时才计算并返回，实现了惰性求值（lazy evaluation）。

如何创建自定义迭代器

你可以用 yield 实现任意复杂的遍历逻辑，比如遍历树结构、过滤数据、生成无限序列等。

Upload audio to AIOZ Stream

快速上传音频至 AIOZ Stream API。支持默认或自定义编码配置创建音频对象，上传文件并完成处理后返回音频链接。

下载

示例：跳过偶数，只返回奇数

public IEnumerable OddNumbers(int start, int count) { int found = 0; int current = start;

while (found < count)
{
    if (current % 2 == 1)
    {
        yield return current;
        found++;
    }
    current++;
}

}

使用方式：

foreach (int n in OddNumbers(10, 5)) { Console.WriteLine(n); // 输出前5个大于等于10的奇数：11,13,15,17,19 }

yield return 和 yield break 的区别

• yield return：返回一个元素，并暂停执行，下次 MoveNext() 调用时继续。
• yield break：终止迭代，不再返回更多元素。

示例：在满足条件时提前退出

public IEnumerable ReadLines() { string line; while ((line = Console.ReadLine()) != null) { if (line == "quit") yield break; // 用户输入 quit 就停止 yield return line.ToUpper(); } }

注意事项

• 不能在匿名方法或 async 方法中使用 yield（C# 7 及更早版本限制；C# 8+ 支持 async streams，但语法不同）。
• 编译器会将包含 yield 的方法转换成一个状态机类，自动管理迭代过程。
• 异常处理要小心：yield 方法中的异常可能在枚举时才抛出，而不是调用时。

基本上就这些。yield 让你写出简洁、高效、内存友好的迭代逻辑，特别适合处理大数据流或需要延迟计算的场景。