在C#中,异步编程是处理耗时操作,如I/O请求、数据库调用或网络请求等,而不阻塞主线程的一种有效方法。Task 类是这种异步操作的核心,它允许我们启动异步操作并等待其完成。然而,有时我们可能需要在任务完成之前取消它,特别是当任务依赖于某些外部条件或用户交互时。在C#中,取消任务通常通过使用 CancellationToken 来实现。
CancellationToken 和 CancellationTokenSource
CancellationToken 是一个结构,用于传递取消操作的通知,如用户请求取消或超时。CancellationTokenSource 是用于生成 CancellationToken 的类,并提供了取消该令牌的方法。
下面是一个简单的示例,展示了如何使用 CancellationToken 和 CancellationTokenSource 来取消一个任务:
using System; using System.Threading; using System.Threading.Tasks; class Program { static async Task Main(string[] args) { using CancellationTokenSource cts = new CancellationTokenSource(); CancellationToken cancellationToken = cts.Token; // 启动一个可以被取消的任务 Task myTask = Task.Run(() => DoWork(cancellationToken), cancellationToken); // 假设一段时间后,我们决定取消任务 await Task.Delay(2000); // 等待2秒 Console.WriteLine("Cancelling the task..."); cts.Cancel(); // 发送取消信号 try { await myTask; // 等待任务完成或捕获到OperationCanceledException异常 } catch (OperationCanceledException) { Console.WriteLine("Task was cancelled"); } } static void DoWork(CancellationToken cancellationToken) { for (int i = 0; i < 10; i++) { if (cancellationToken.IsCancellationRequested) { Console.WriteLine("Cancellation requested."); // 检查取消标记,如果已请求取消,则退出循环或执行其他清理操作 break; // 或者返回,抛出OperationCanceledException等。 } // 模拟工作正在进行中... Thread.Sleep(500); // 不要在生产代码中使用Thread.Sleep! 这里只是为了示例。 Console.WriteLine("Working..."); } } }
在这个示例中,我们创建了一个 CancellationTokenSource 实例,并使用其 Token 属性生成了一个 CancellationToken。然后,我们将这个令牌传递给了一个在后台运行的任务(通过 Task.Run)。稍后,我们决定取消这个任务,于是调用了 CancellationTokenSource.Cancel 方法来提供取消信号。在任务代码中,我们定期检查取消标记,如果已请求取消,则退出循环。
注意事项和最佳实践:
- 定期检查取消标记:在你的任务代码中,你应该定期检查 CancellationToken.IsCancellationRequested 属性,以便在收到取消请求时能够迅速响应。
- 处理取消请求:当检测到取消请求时,你的代码应该尽快停止当前的操作并退出。你可以通过抛出 OperationCanceledException 异常、返回或执行其他适当的清理操作来实现这一点。
- 使用正确的等待方式:在等待可能被取消的任务时,最好使用 await 关键字而不是 Task.Wait() 或 Task.Result,因为后者在任务被取消时会抛出 AggregateException 而不是 OperationCanceledException,这可能会使异常处理更加复杂。
- 资源清理:确保在取消操作后妥善处理和清理所有已分配的资源,以避免内存泄漏或其他潜在问题。这包括关闭文件句柄、释放数据库连接等。
- 文档和测试:如果你的方法接受一个 CancellationToken 参数,确保在方法的文档中明确说明这一点,并编写针对取消操作的单元测试,以确保你的代码在收到取消信号时能够正确响应。
原文地址:https://mp.weixin.qq.com/s/S8WbPrIbO4h4woW3DdvSdQ