何时及为何要向TaskCompletionSource.SetCanceled传入CancellationToken？

你的代码里之所以看起来传不传CancellationToken没区别，是因为TaskCompletionSource的无参构造没有和取消令牌建立关联——你调用SetCanceled(cts.Token)只是把令牌附加到了取消异常上，但并没有让令牌具备主动触发任务取消的能力。

核心用途 #

• 主动触发任务终止：允许外部代码向运行中的任务发送取消信号，任务可以监听这个信号，及时停止执行并释放资源，避免不必要的资源消耗。
• 传递取消上下文：在嵌套的异步操作链中共享同一个取消令牌，一旦令牌触发取消，所有关联的异步方法都能响应这个信号，实现统一取消。
• 区分取消原因：当任务被取消时，携带的令牌可以帮助判断是外部主动发起的取消，还是任务内部逻辑触发的取消，便于后续处理。

修正你的代码示例 #

如果要让CancellationToken真正发挥作用，应该使用带令牌参数的TaskCompletionSource构造函数，让它和令牌绑定：

public async void Test()
{
    var cts = new CancellationTokenSource();
    // 传入令牌，让TCS与令牌关联
    var tcs = new TaskCompletionSource(cts.Token);

    // 模拟1秒后触发取消
    cts.CancelAfter(1000);

    try
    {
        await tcs.Task;
    }
    catch (TaskCanceledException e)
    {
        Console.WriteLine($"任务已取消：{e.Message}");
    }
}

实际场景中的典型用法 #

在IO密集型或长时间运行的任务中，你可以在任务内部监听令牌状态：

public async Task LongRunningTask(CancellationToken token)
{
    while (!token.IsCancellationRequested)
    {
        // 执行重复操作
        await Task.Delay(500, token);
        Console.WriteLine("任务运行中...");
    }
    // 抛出取消异常，让调用方捕获处理
    token.ThrowIfCancellationRequested();
}

内容的提问来源于stack exchange，提问作者K 1