await
是 C#
中用于等待异步操作完成的关键字。它通常与 async
一起使用,用于异步方法中等待异步操作的完成,并且在异步操作完成后,恢复执行该方法。
下面是对 await
的详细介绍以及一些示例代码:
1. 基本用法:
await 关键字用于等待一个返回 Task
或 Task<T>
对象的异步方法完成。当异步操作完成后,await
表达式返回其结果(如果有的话)。
async Task MyAsyncMethod()
{
// 异步操作,例如 Task.Delay
await Task.Delay(1000);
Console.WriteLine("异步操作完成");
}
2. 等待 Task 完成:
async Task<int> MyAsyncMethod()
{
await Task.Delay(1000);
return 42;
}
async Task Main()
{
int result = await MyAsyncMethod();
Console.WriteLine($"异步操作的结果为:{result}");
}
3. 等待多个任务完成:
Task.WhenAll
方法可以等待多个任务全部完成。
async Task Main()
{
Task<int> task1 = MyAsyncMethod1();
Task<int> task2 = MyAsyncMethod2();
await Task.WhenAll(task1, task2);
Console.WriteLine($"task1 的结果为:{task1.Result}");
Console.WriteLine($"task2 的结果为:{task2.Result}");
}
4. 等待任意一个任务完成:
Task.WhenAny
方法可以等待多个任务中的任意一个完成。
async Task Main()
{
Task<int> task1 = MyAsyncMethod1();
Task<int> task2 = MyAsyncMethod2();
Task<int> completedTask = await Task.WhenAny(task1, task2);
Console.WriteLine($"第一个完成的任务结果为:{completedTask.Result}");
}
5. 异常处理:
在 try-catch
块中使用 await
来捕获异步操作中的异常。
async Task Main()
{
try
{
await MyAsyncMethod();
}
catch (Exception ex)
{
Console.WriteLine($"异步操作出现异常:{ex.Message}");
}
}
6. 取消异步操作:
使用 CancellationToken
和 Task.Delay
结合,可以实现异步操作的取消。
async Task MyAsyncMethod(CancellationToken cancellationToken)
{
await Task.Delay(1000, cancellationToken);
Console.WriteLine("异步操作完成");
}
async Task Main()
{
using (var cancellationTokenSource = new CancellationTokenSource())
{
// 设置 500ms 后取消操作
cancellationTokenSource.CancelAfter(500);
try
{
await MyAsyncMethod(cancellationTokenSource.Token);
}
catch (TaskCanceledException)
{
Console.WriteLine("异步操作被取消");
}
}
}
await
关键字的作用是将异步操作的等待转换为对异步结果的处理,使得异步编程更加简洁和可读。