讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

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

夏宇酱_5551

夏宇酱_5551

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

|

956人浏览过

|

来源于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 重复传入多次——不会报错,但属于冗余注册,无实际收益

示例:

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
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

链式源一旦被触发取消,就彻底不可恢复;而且它不会自动继承原始 CancellationTokenSource 的 CancelAfter 行为——即使你传入的是一个设置了 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论文写作工具,复旦大学NLP团队推出的AI学术智能体。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

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

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

15146

2023.09.14

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

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

1765

2023.09.14

token怎么获取
token怎么获取

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

4237

2023.12.21

token什么意思
token什么意思

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

6401

2024.03.01

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

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

4738

2023.08.10

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

20

2026.11.06

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

20

2026.11.06

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

40

2026.11.05

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn