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

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()

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