0

0

C# CancellationToken链式取消 C#如何使用CreateLinkedTokenSource

月夜之吻

月夜之吻

发布时间:2026-02-27 07:25:27

|

896人浏览过

|

来源于php中文网

原创

cancellationtokensource.createlinkedtokensource用于合并多个cancellationtoken,任一源取消即触发联动取消;返回新cancellationtokensource,需用.token获取令牌;必须dispose()防泄漏,不可传已取消token,不支持cancelafter继承。

c# cancellationtoken链式取消 c#如何使用createlinkedtokensource

什么是 CancellationTokenSource.CreateLinkedTokenSource

CreateLinkedTokenSource 用来把多个 CancellationToken 合并成一个“联动取消令牌”,只要其中任意一个被取消,新生成的 CancellationToken 就立刻进入已取消状态。它不是简单地“或”逻辑组合,而是真正注册了取消回调,响应底层取消通知。

常见使用场景包括:既要响应用户主动取消(比如 UI 按钮),又要响应超时(TimeSpan),还要响应父操作的取消(比如 ASP.NET Core 中的 HttpContext.RequestAborted)。

注意:CreateLinkedTokenSource 返回的是新的 CancellationTokenSource,不是 CancellationToken;你得用它的 Token 属性去传给异步方法。

如何正确创建和使用链式取消源

调用方式很简单,但参数顺序和生命周期管理容易出错:

  • 支持两个或多个 CancellationToken 参数,例如:CancellationTokenSource.CreateLinkedTokenSource(token1, token2, token3)
  • 不能传入已取消的 CancellationToken —— 虽然不会抛异常,但返回的源会立即处于取消状态,后续无法再触发取消(除非你手动调用 Cancel()
  • 必须在使用完毕后调用 Dispose(),否则可能泄漏注册的回调(尤其在频繁创建的循环或高并发请求中)
  • 不要把同一个 CancellationTokenSource.Token 重复传入多次——不会报错,但属于冗余注册,无实际收益

示例:

Genspark
Genspark

Genspark 是一款创新的 AI 搜索引擎,致力于提供比传统搜索引擎更高效、准确和无偏见的信息获取方式。

下载
CancellationTokenSource cts1 = new CancellationTokenSource(TimeSpan.FromSeconds(3));
CancellationTokenSource cts2 = new CancellationTokenSource();
CancellationToken linked = CancellationTokenSource
    .CreateLinkedTokenSource(cts1.Token, cts2.Token)
    .Token;

// 后续传给 Task.Run、HttpClient.GetAsync 等接受 CancellationToken 的 API
await DoWorkAsync(linked);

为什么不能直接用 “||” 或 “WaitHandle.WaitAny” 模拟链式取消

因为 CancellationToken 的取消机制依赖内部的 Registration 和同步上下文调度,不是纯布尔状态轮询:

  • token1.IsCancellationRequested || token2.IsCancellationRequested 是静态快照,无法触发下游的取消回调(如 Register 注册的动作)
  • WaitHandle.WaitAny 要求每个 token 都有 WaitHandle,而默认 CancellationToken 不暴露该句柄,且线程阻塞不符合 async/await 场景
  • 手动监听多个 token 并自己调用 Cancel() 容易漏掉异常路径、竞态条件,还破坏了 cancellation 的统一传播语义

所以,别绕开 CreateLinkedTokenSource 自己造轮子,它已经处理好了线程安全、回调注册、资源清理这些细节。

容易被忽略的坑:linked token 的取消不可逆,且不继承父源的 CancelAfter

链式源一旦被触发取消,就彻底不可恢复;而且它不会自动继承原始 CancellationTokenSourceCancelAfter 行为——即使你传入的是一个设置了 CancelAfter(5000) 的源,链式源本身并不会自动倒计时。

  • 如果你需要“最长等待 5 秒 + 用户可提前取消”,必须显式创建带超时的 CancellationTokenSource,再参与链接
  • 如果某个参与链接的源被 Dispose() 了,其 Token 仍可安全用于 CreateLinkedTokenSource(.NET 6+ 保证行为稳定),但旧版本(如 .NET Framework 4.7.2)中可能引发 ObjectDisposedException,建议避免 dispose 后继续引用其 Token
  • ASP.NET Core 中,HttpContext.RequestAborted 是只读 token,没有对应源,所以只能作为输入参与链接,不能从中调用 Cancel()

链式取消看着简单,真正用稳的关键在于:谁负责创建、谁负责取消、谁负责释放 —— 这三件事没理清,很容易出现取消不生效,或者资源泄漏。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

6462

2023.09.14

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

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

838

2023.09.14

token怎么获取
token怎么获取

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

1087

2023.12.21

token什么意思
token什么意思

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

1730

2024.03.01

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

721

2023.08.10

Golang 实际项目案例:从需求到上线
Golang 实际项目案例:从需求到上线

《Golang 实际项目案例:从需求到上线》以真实业务场景为主线,完整覆盖需求分析、架构设计、模块拆分、编码实现、性能优化与部署上线全过程,强调工程规范与实践决策,帮助开发者打通从技术实现到系统交付的关键路径,提升独立完成 Go 项目的综合能力。

1

2026.02.26

Golang Web 开发路线:构建高效后端服务
Golang Web 开发路线:构建高效后端服务

《Golang Web 开发路线:构建高效后端服务》围绕 Go 在后端领域的工程实践,系统讲解 Web 框架选型、路由设计、中间件机制、数据库访问与接口规范,结合高并发与可维护性思维,逐步构建稳定、高性能、易扩展的后端服务体系,帮助开发者形成完整的 Go Web 架构能力。

3

2026.02.26

Golang 并发编程专题:掌握多核时代的核心技能
Golang 并发编程专题:掌握多核时代的核心技能

《Golang 并发编程专题:掌握多核时代的核心技能》系统讲解 Go 在并发领域的设计哲学与实践方法,深入剖析 goroutine、channel、调度模型与并发安全机制,结合真实场景与性能思维,帮助开发者构建高吞吐、低延迟、可扩展的并发程序,全面提升多核时代的工程能力。

5

2026.02.26

batoto漫画官网入口与网页版访问指南
batoto漫画官网入口与网页版访问指南

本专题系统整理batoto漫画官方网站最新可用入口,涵盖最新官网地址、网页版登录页面及防走失访问方式说明,帮助用户快速找到batoto漫画官方平台,稳定在线阅读各类漫画内容。

353

2026.02.25

热门下载

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

精品课程

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

共94课时 | 10.3万人学习

C 教程
C 教程

共75课时 | 5万人学习

C++教程
C++教程

共115课时 | 19.6万人学习

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

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