Async streams with IAsyncEnumerable in C Sharp (C#) - Step-by-Step Execution

Concept Flow - Async streams with IAsyncEnumerable

Start async method

↓

Yield value asynchronously

↓

Caller awaits next value

↓

Repeat yield until done

↓

End async stream

↓

Caller finishes iteration

The async method produces values one by one asynchronously, and the caller awaits each value before continuing.

Execution Sample

C Sharp (C#)

async IAsyncEnumerable<int> CountAsync()
{
    for (int i = 1; i <= 3; i++)
    {
        await Task.Delay(1000);
        yield return i;
    }
}

This async stream method yields numbers 1 to 3 with a 1-second delay between each.

Execution Table

Step	i value	Action	Yielded Value	Caller awaits
1	1	Start loop, delay 1s		Caller waits for value
2	1	Yield return 1	1	Caller receives 1
3	2	Start next loop, delay 1s		Caller waits for next value
4	2	Yield return 2	2	Caller receives 2
5	3	Start next loop, delay 1s		Caller waits for next value
6	3	Yield return 3	3	Caller receives 3
7	4	Loop ends (i=4 > 3)		Caller finishes iteration

💡 Loop ends when i becomes 4, which is greater than 3, so async stream completes.

Variable Tracker

Variable	Start	After 1	After 2	After 3	Final
i	0	1	2	3	4

Key Moments - 3 Insights

Why does the caller wait after each yield return?

Because the method yields values asynchronously, the caller must await each value before continuing, as shown in steps 2, 4, and 6 of the execution table.

What happens when the loop condition fails?

When i becomes 4, which is greater than 3, the loop ends and the async stream completes, as shown in step 7 of the execution table.

Why is Task.Delay used before yield return?

Task.Delay simulates asynchronous work or waiting, so the method pauses before yielding each value, making the stream truly asynchronous (see steps 1, 3, and 5).

Visual Quiz - 3 Questions

Look at the execution table, what value is yielded at step 4?

A 1

B 2

C 3

D No value yielded

💡 Hint

Check the 'Yielded Value' column at step 4 in the execution table.

At which step does the async stream complete?

A Step 6

B Step 7

C Step 3

D Step 1

💡 Hint

Look for the step where the loop ends and the caller finishes iteration in the execution table.

If Task.Delay was removed, how would the execution table change?

A Caller would not wait between yields

B Values would be yielded in reverse order

C Loop would run infinitely

D No values would be yielded

💡 Hint

Task.Delay causes the caller to wait; removing it means no delay between yields (see Action and Caller awaits columns).

Concept Snapshot

Async streams use IAsyncEnumerable<T> to produce values asynchronously.
Use 'yield return' with 'await' inside an async method.
Caller uses 'await foreach' to consume values one by one.
Each value is awaited before next is produced.
Useful for streaming data or asynchronous sequences.

Full Transcript

This example shows an async method CountAsync that yields numbers 1 to 3 with a 1-second delay before each yield. The execution table traces each step: starting the loop, delaying, yielding a value, and the caller awaiting that value. Variables like 'i' change from 0 to 4 as the loop progresses. Key moments clarify why the caller waits after each yield, what happens when the loop ends, and why Task.Delay is used. The visual quiz tests understanding of yielded values, completion step, and effect of removing delay. Async streams let you produce data asynchronously, making it easy to handle sequences that take time to generate.