0

0

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

星降

星降

发布时间:2025-11-02 13:00:02

|

566人浏览过

|

来源于php中文网

原创

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

.net中如何使用cancellationtoken取消异步操作

在 .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) 这类支持取消的方法,会在取消时自动抛出异常,无需手动处理。

ClipDrop
ClipDrop

Stability.AI出品的图片处理系列工具(背景移除、图片放大、打光)

下载

安全地处理取消异常

当操作被取消时,通常会抛出 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 一路传下去,并在合适的地方响应它。只要调用方能控制取消时机,被调用的方法就能及时退出,不浪费资源。

相关专题

更多
登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

6096

2023.09.14

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

806

2023.09.14

token怎么获取
token怎么获取

获取token值的方法:1、小程序调用“wx.login()”获取 临时登录凭证code,并回传到开发者服务器;2、开发者服务器以code换取,用户唯一标识openid和会话密钥“session_key”。想了解更详细的内容,可以阅读本专题下面的文章。

1062

2023.12.21

token什么意思
token什么意思

token是一种用于表示用户权限、记录交易信息、支付虚拟货币的数字货币。可以用来在特定的网络上进行交易,用来购买或出售特定的虚拟货币,也可以用来支付特定的服务费用。想了解更多token什么意思的相关内容可以访问本专题下面的文章。

1250

2024.03.01

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

72

2026.01.16

全民K歌得高分教程大全
全民K歌得高分教程大全

本专题整合了全民K歌得高分技巧汇总,阅读专题下面的文章了解更多详细内容。

131

2026.01.16

C++ 单元测试与代码质量保障
C++ 单元测试与代码质量保障

本专题系统讲解 C++ 在单元测试与代码质量保障方面的实战方法,包括测试驱动开发理念、Google Test/Google Mock 的使用、测试用例设计、边界条件验证、持续集成中的自动化测试流程,以及常见代码质量问题的发现与修复。通过工程化示例,帮助开发者建立 可测试、可维护、高质量的 C++ 项目体系。

54

2026.01.16

java数据库连接教程大全
java数据库连接教程大全

本专题整合了java数据库连接相关教程,阅读专题下面的文章了解更多详细内容。

39

2026.01.15

Java音频处理教程汇总
Java音频处理教程汇总

本专题整合了java音频处理教程大全,阅读专题下面的文章了解更多详细内容。

19

2026.01.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go 教程
Go 教程

共32课时 | 3.9万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号