CancellationToken是.NET中用于协作式取消异步操作的机制，由CancellationTokenSource创建，调用其Cancel()方法后，所有监听该token的操作会收到取消通知；任务需定期检查token状态并主动退出，实现优雅终止。常用于用户取消、超时中断或应用关闭等场景。使用时需将token传递给支持取消的操作，并在执行过程中通过IsCancellationRequested或ThrowIfCancellationRequested判断是否取消。示例中，LongRunningOperation循环检查token，若取消请求发出则提前结束任务。
CancellationToken 是 .NET 中用于协作式取消异步或长时间运行操作的机制。它本身不强制终止任务，而是提供一种“通知”方式，让目标操作可以主动响应取消请求，从而实现优雅退出。
什么是 CancellationToken？
CancellationToken 通常由 CancellationTokenSource 创建。当调用 CancellationTokenSource 的 Cancel() 方法时，所有监听该 token 的操作会收到取消通知。关键在于“协作”——任务必须定期检查 token 状态并自行决定如何退出。
常用场景包括：- 用户点击“取消”按钮中断后台下载
- API 请求超时自动终止
- 应用关闭时清理正在执行的任务
如何使用 CancellationToken 取消异步任务？
在实际编码中，需要将 token 传递给支持取消的操作，并在适当位置检查其状态。
var cts = new CancellationTokenSource();
var token = cts.Token;
async Task LongRunningOperation(CancellationToken ct)
{
for (int i = 0; i < 100; i++)
{
// 模拟工作
await Task.Delay(100, ct); // 支持取消的延迟
// 手动检查是否已取消
ct.ThrowIfCancellationRequested();
Console.WriteLine($"处理进度: {i + 1}%");
}
}
// 启动任务
var task = LongRunningOperation(token);
// 模拟外部触发取消
await Task.Delay(500);
cts.Cancel(); // 发起取消请求
try
{
await task;
}
catch (OperationCanceledException)
{
Console.WriteLine("任务已被取消");
}
在这个例子中，Task.Delay 接收 token 并在取消时抛出异常。手动调用 ThrowIfCancellationRequested 可确保及时响应取消信号。
最佳实践与注意事项
要正确使用取消机制，需注意以下几点：
- 始终传递 CancellationToken 到支持它的 API（如 HttpClient.GetAsync、StreamReader.ReadLineAsync）
- 在循环中定期检查 token 状态，避免长时间阻塞无法响应取消
- 捕获 OperationCanceledException 并区分正常取消和错误
- 使用 using 或 try-finally 确保 CancellationTokenSource 被释放
- 考虑设置超时：new CancellationTokenSource(TimeSpan.FromSeconds(30))
