Язык программирования C#9 и платформа .NET5

  });

  var task3 = Task.Run( =>
  {
  Thread.Sleep(1_000);
  Console.WriteLine("Done with third task!");
  });
  await Task.WhenAll(task1, task2, task3);
 }

Запустив программу, вы увидите, что три задачи запускаются в порядке от наименьшего значения, указанного при вызове метода Sleep:

 Fun With Async ===>
 Done with work!
 Void method completed
 Done with second task!
 Done with third task!
 Done with first task!
 Completed

Существует также метод WhenAnу, возвращающий задачу, которая завершилась. Для демонстрации работы WhenAny измените последнюю строку метода MultipleAwaits следующим образом:

 await Task.WhenAny(task1, task2, task3);

В результате вывод становится таким:

 Fun With Async ===>
 Done with work!
 Void method completed
 Done with second task!
 Completed
 Done with third task!
 Done with first task!

Вызов асинхронных методов из неасинхронных методов

В каждом из предшествующих примеров ключевое слово async использовалось для возвращения в поток вызывающего кода, пока выполняется асинхронный метод. В целом ключевое слово await может применяться только в методе, помеченном как async. А что если вы не можете (или не хотите) помечать метод с помощью async?

К счастью, существуют другие способы вызова асинхронных методов. Если вы просто не используете ключевое слово await, тогда код продолжает работу после асинхронного метода, не возвращая управление вызывающему коду. Если вам необходимо ожидать завершения асинхронного метода (что происходит, когда применяется ключевое слово await), то существуют два подхода.

Первый подход предусматривает просто использование свойства Result с методами, возвращающими Task<T>, или метода Wait с методами, возвращающими Task/Task<T>. (Вспомните, что метод, который возвращает значение, обязан возвращать Task<T>, будучи асинхронным, а метод, не имеющий возвращаемого значения, возвращает Task, когда является асинхронным.) Если метод терпит неудачу, то возвращается AggregateException.

Можете также добавить вызов GetAwaiter.GetResult, который обеспечивает такой же эффект, как ключевое слово await в асинхронном методе, и распространяет исключения в той же манере, что и async/await. Тем не менее, указанные методы помечены в документации как "не предназначенные для внешнего использования", а это значит, что они могут измениться либо вовсе исчезнуть в какой-то момент в будущем. Вызов GetAwaiter.GetResult работает как с методами, возвращающими значение, так и с методами без возвращаемого значения.

На заметку! Решение использовать свойство Result или вызов GetAwaiter.GetResult с Task<T> возлагается полностью на вас, и большинство разработчиков принимают решение, основываясь на обработке исключений. Если ваш метод возвращает Task, тогда вы должны применять вызов GetAwaiter.GetResult или Wait.

Например, вот как вы могли бы вызывать метод DoWorkAsync:

 Console.WriteLine(DoWorkAsync.Result);
 Console.WriteLine(DoWorkAsync.GetAwaiter.GetResult);

Чтобы остановить выполнение до тех пор, пока не произойдет возврат из метода с возвращаемым типом void, просто вызовите метод Wait на объекте Task:

 MethodReturningVoidAsync.Wait;

Ожидание с помощью await в блоках catch и finally

В версии C# 6 появилась возможность помещения вызовов await в блоки catch и finally. Для этого сам метод обязан быть async. Указанная возможность демонстрируется в следующем примере кода:

 static async Task<string> MethodWithTryCatch
 {
  try
  {
  //Do some work
  return "Hello";
  }
  catch (Exception ex)
  {
  await LogTheErrors;
  throw;
  }
  finally
  {
  await DoMagicCleanUp;
  }
 }

Обобщенные возвращаемые типы в асинхронных методах (нововведение в версии 7.0)

До выхода версии C# 7 возвращаемыми типами методов async были только Task, Task<T> и void. В версии C# 7 доступны дополнительные возвращаемые типы при условии, что они следуют шаблону с ключевым словом async. В качестве конкретного примера можно назвать тип ValueTask. Введите код, подобный показанному ниже:

 static async ValueTask<int> ReturnAnInt
 {
  await Task.Delay(1_000);
  return 5;
 }

К типу ValueTask применимы все те же самые правила, что и к типу Task, поскольку ValueTask — это просто объект Task для типов значений, заменяющий собой принудительное размещение объекта в куче.