RU 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.