CSharp Async

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

async, await, Task та ValueTask

Посібник C# · Приклади UO

async дозволяє await усередині методу. await очікує завершення операції та продовжує виконання без обов'язкового створення нового потоку. Task представляє завершення операції, Task<T> — завершення та результат. Асинхронний метод виконує синхронну частину до першого незавершеного очікування.

Простий приклад (Example.cs)

Збережіть цей приклад окремо як Example.cs. Запускайте його незалежно від інших прикладів на сторінці.

Example.cs:

// PROJECT-EXAMPLE
async System.Threading.Tasks.Task<int> ReadAsync()
{
    await System.Threading.Tasks.Task.Delay(1);
    return 7;
}
System.Console.WriteLine(await ReadAsync());

Результат:

7

async Task<int> CalculateAsync(int value)
{
    await WaitAsync(10);
    return value * 2;
}
int result = await CalculateAsync(21);
UO.Print(result.ToString());

Task<int> FirstAsync() => Task.FromResult(2);
Task<int> SecondAsync() => Task.FromResult(3);
int[] results = await Task.WhenAll(FirstAsync(), SecondAsync());
UO.Print(results.Sum().ToString());

Task.WhenAll чекає на всі завдання, WhenAny — першу, що завершилася. Інші завдання при WhenAny не скасовуються автоматично. ValueTask корисний у спеціальних API і має обмеження на повторне очікування. Уникайте .Wait() та .Result в асинхронному ланцюжку; чекайте через await.

Офіційна документація: async, await, Task та ValueTask — Microsoft Learn.