RU CSharp Iterators

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

Итераторы, yield и async-последовательности

Руководство 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 и async-последовательности — Microsoft Learn.