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

什么是 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重复传入多次——不会报错,但属于冗余注册,无实际收益
示例:
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()
链式取消看着简单,真正用稳的关键在于:谁负责创建、谁负责取消、谁负责释放 —— 这三件事没理清,很容易出现取消不生效,或者资源泄漏。










