await
是 C#
中用于等待异步操作完成的关键字。它通常与 async
一起使用,用于异步方法中等待异步操作的完成,并且在异步操作完成后,恢复执行该方法。
下面是对 await
的详细介绍以及一些示例代码:
1. 基本用法:
await 关键字用于等待一个返回 Task
或 Task<T>
对象的异步方法完成。当异步操作完成后,await
表达式返回其结果(如果有的话)。
async Task MyAsyncMethod()
{// 异步操作,例如 Task.Delayawait 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
关键字的作用是将异步操作的等待转换为对异步结果的处理,使得异步编程更加简洁和可读。