.NET中如何使用CancellationToken取消异步操作

CancellationToken用于协作式取消异步操作，CancellationTokenSource负责触发取消；2. 将Token传递给异步方法，调用Cancel()发送取消信号；3. 异步方法需定期检查Token并抛出OperationCanceledException以响应取消。

在 .NET 中，CancellationToken 是用于协作式取消异步操作的核心机制。它允许你在长时间运行的任务（如网络请求、文件读取或密集计算）中响应取消请求，从而提升应用的响应性和资源利用率。

理解 CancellationToken 和 CancellationTokenSource

CancellationToken 本身不触发取消，它只是一个信号令牌，用于监听是否收到取消请求。真正的取消控制由 CancellationTokenSource（简称 CTS）发出。

典型用法是创建一个 CancellationTokenSource，然后将它的 Token 传递给异步方法。当调用 CTS 的 Cancel() 方法时，所有监听该 Token 的操作都会收到通知。

示例：

var cts = new CancellationTokenSource();
CancellationToken token = cts.Token;

// 启动异步操作并传入 token
var task = LongRunningOperationAsync(token);

// 在某个条件下触发取消
cts.Cancel(); // 发送取消信号

在异步方法中处理取消请求

异步方法需要定期检查 token 是否被取消，并在适当时候抛出 OperationCanceledException。

.NET 中很多内置异步方法（如 HttpClient.GetAsync、StreamReader.ReadLineAsync）都支持 CancellationToken 参数，直接传入即可。

自定义异步方法中使用方式如下：

public async Task LongRunningOperationAsync(CancellationToken token)
{
    for (int i = 0; i < 100; i++)
    {
        // 模拟工作
        await Task.Delay(100, token); // 支持取消的等待

        // 手动检查取消（可选，更精细控制）
        token.ThrowIfCancellationRequested();

        // 或者只检查
        if (token.IsCancellationRequested)
        {
            // 清理资源
            return;
        }
    }
}

注意：使用 Task.Delay(100, token) 这类支持取消的方法，会在取消时自动抛出异常，无需手动处理。

PPT.CN,PPTCN,PPT.CN是什么,PPT.CN官网,PPT.CN如何使用

一键操作，智能生成专业级PPT

37

查看详情

安全地处理取消异常

当操作被取消时，通常会抛出 OperationCanceledException。你应该捕获这个异常并判断是否为预期的取消行为。

示例：

try
{
    await LongRunningOperationAsync(cts.Token);
}
catch (OperationCanceledException ex) when (ex.CancellationToken == cts.Token)
{
    Console.WriteLine("操作已被用户取消。");
}
catch (Exception ex)
{
    Console.WriteLine($"发生错误: {ex.Message}");
}

通过匹配 CancellationToken，可以区分是哪个取消源导致的异常，避免误判。

设置超时自动取消

除了手动取消，还可以设置超时时间让操作自动终止：

var cts = new CancellationTokenSource();
cts.CancelAfter(TimeSpan.FromSeconds(30)); // 30秒后自动取消

await LongRunningOperationAsync(cts.Token);

这在防止任务无限等待时非常有用，比如调用外部 API。

基本上就这些。关键是把 token 一路传下去，并在合适的地方响应它。只要调用方能控制取消时机，被调用的方法就能及时退出，不浪费资源。

以上就是.NET中如何使用CancellationToken取消异步操作的详细内容，更多请关注php中文网其它相关文章！