ZH TW CSharp Iterators

Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

迭代器、yield 和非同步序列

手冊C# · 範例UO

使用 yield return 的方法給出枚舉的元素，yield break 完成序列。它的主體通常不是在創建序列時開始工作，而是在枚舉時開始工作。 IAsyncEnumerable<T>支援透過await foreach異步接收元素。

簡單範例 (Example.cs)

請將此範例另存為 Example.cs，並與本頁其他範例分開執行。

Example.cs:

// PROJECT-EXAMPLE
System.Collections.Generic.IEnumerable<int> Numbers()
{
    yield return 1;
    yield return 2;
}
foreach (int value in Numbers()) System.Console.WriteLine(value);

結果:

1
2

IEnumerable<int> Range(int count)
{
    for (int i = 0; i < count; i++) yield return i;
}
foreach (int value in Range(3))
{
    UO.Print(value.ToString());
}

async IAsyncEnumerable<int> Ticks()
{
    for (int i = 0; i < 3; i++)
    {
        await WaitAsync(10);
        yield return i;
    }
}
await foreach (int tick in Ticks())
{
    UO.Print($"Tick={tick}");
}

不要返回活動腳本之外的序列，該腳本稍後將訪問其可播放的API。枚舉時，來源資料可能已變更； ToArray 拍攝照片。

官方文件：迭代器、yield 和非同步序列 - Microsoft Learn。