EN CSharp Keyword await

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

C#: await

Handbook C# · Practical Guide

Asynchronously waits for an awaitable operation and receives its result; operation errors appear when await.

Simple example (Example.cs)

Save this example separately as Example.cs. Run it independently of the other examples on this page.

Example.cs:

// PROJECT-EXAMPLE
await System.Threading.Tasks.Task.Delay(1);
System.Console.WriteLine("Done");

Result:

Done

Syntax

var result = await operation;

Example 1: simple form

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using System.IO;
using System.Runtime.InteropServices;
using System.Runtime.CompilerServices;

public static class Program
{
    public static async Task Main(string[] args)
    {
        int result = await Jobs.DoubleAsync(4);
        Console.WriteLine(result);
    }
}
public static class Jobs { public static async Task<int> DoubleAsync(int value) { await Task.Delay(1); return value * 2; } }

Example 2: another practical form

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using System.IO;
using System.Runtime.InteropServices;
using System.Runtime.CompilerServices;

public static class Program
{
    public static async Task Main(string[] args)
    {
        Task<int>[] jobs = [Jobs.CountAsync(2), Jobs.CountAsync(3)];
        int[] results = await Task.WhenAll(jobs);
        Console.WriteLine(results.Sum());
    }
}
public static class Jobs { public static async Task<int> CountAsync(int value) { await Task.Yield(); return value; } }

Official source: Microsoft Learn.