深度解析CancellationToken：.NET中的优雅取消机制

步步为营DotNet

发布于 2026-06-16 21:16:31

1140

深度解析CancellationToken：.NET中的优雅取消机制

在多线程编程、异步操作场景下，难免会遇到需要提前终止操作的情况。比如用户在下载过程中突然取消，或者一个任务执行时间过长需要强制停止。CancellationToken正是为优雅地处理这些情况而生，深入理解它有助于开发者编写健壮、高效且响应灵敏的应用程序。

一、技术背景

应用场景
- 用户操作取消：如在图形界面应用中，用户点击取消按钮终止一个长时间运行的任务。
- 超时控制：设置任务执行的最长时间，超过则取消操作。
解决的核心问题
- 提供一种标准方式来请求取消正在执行的操作，避免资源浪费和未完成任务带来的异常。
- 让代码具备响应取消请求的能力，提升用户体验和系统稳定性。

二、核心原理

CancellationToken的本质：它是一个结构体，主要用于传递取消信号。可以将其看作一个“令牌”，当需要取消某个操作时，就对这个“令牌”进行标记。
协作取消模式：.NET采用协作式取消模式。这意味着任务本身需要主动检查取消请求并适时响应。CancellationToken不会强制终止任务，而是提供一种机制，让任务有机会在合适的时机优雅地停止。

三、底层实现剖析

源码片段：CancellationTokenSource类用于创建CancellationToken实例，并提供取消操作的方法。

public class CancellationTokenSource : IDisposable
{
    private CancellationTokenRegistration _parentRegistration;
    private CancellationTokenRegistration _disposeRegistration;
    private volatile int _state;
    // 省略其他代码

    public void Cancel()
    {
        Cancel(false);
    }

    private void Cancel(bool throwOnFirstException)
    {
        if (Interlocked.CompareExchange(ref _state, (int)CancellationTokenSourceState.Canceled, (int)CancellationTokenSourceState.Created) != (int)CancellationTokenSourceState.Created)
        {
            return;
        }
        // 触发取消通知
        // 省略通知相关代码
    }
}

关键逻辑：CancellationTokenSource通过内部状态变量_state来跟踪状态。Cancel方法首先使用Interlocked.CompareExchange原子操作尝试将状态从Created改为Canceled，如果成功则触发取消通知。

四、代码示例

（一）基础用法

功能说明：演示如何使用CancellationToken取消一个简单的异步任务。
代码

using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var cts = new CancellationTokenSource();
        CancellationToken token = cts.Token;

        Task task = Task.Run(() => DoWork(token), token);

        // 模拟其他操作
        await Task.Delay(2000); 

        // 取消任务
        cts.Cancel(); 

        try
        {
            await task;
        }
        catch (OperationCanceledException)
        {
            Console.WriteLine("任务已取消");
        }
    }

    static void DoWork(CancellationToken token)
    {
        while (!token.IsCancellationRequested)
        {
            Console.WriteLine("工作进行中...");
            Task.Delay(500).Wait();
        }
        Console.WriteLine("收到取消请求，停止工作");
    }
}

关键注释：CancellationTokenSource创建CancellationToken。DoWork方法通过token.IsCancellationRequested检查是否收到取消请求。主线程在适当时候调用cts.Cancel()发出取消信号，try - catch块捕获OperationCanceledException。
运行结果：程序先输出若干次“工作进行中…”，2秒后输出“收到取消请求，停止工作”和“任务已取消”。

（二）进阶场景 - 超时取消

功能说明：设定任务执行超时时间，若任务未在规定时间内完成则自动取消。
代码

using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using (var cts = new CancellationTokenSource(TimeSpan.FromSeconds(3)))
        {
            CancellationToken token = cts.Token;

            Task task = Task.Run(() => LongRunningWork(token), token);

            try
            {
                await task;
            }
            catch (OperationCanceledException)
            {
                Console.WriteLine("任务超时被取消");
            }
        }
    }

    static void LongRunningWork(CancellationToken token)
    {
        for (int i = 0; i < 10; i++)
        {
            if (token.IsCancellationRequested)
            {
                Console.WriteLine("收到取消请求，停止工作");
                return;
            }
            Console.WriteLine($"工作步骤 {i}");
            Task.Delay(1000).Wait();
        }
    }
}

关键注释：CancellationTokenSource构造函数中设置了3秒的超时时间。LongRunningWork方法在每次循环中检查取消请求，若收到则停止工作。
预期效果：程序输出“工作步骤 0”到“工作步骤 2”后，输出“收到取消请求，停止工作”和“任务超时被取消”。

（三）避坑案例

常见错误：在异步方法中未正确处理CancellationToken，导致无法响应取消请求。

using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var cts = new CancellationTokenSource();
        CancellationToken token = cts.Token;

        Task task = Task.Run(() => IncorrectAsyncWork());

        await Task.Delay(2000);
        cts.Cancel();

        try
        {
            await task;
        }
        catch (OperationCanceledException)
        {
            Console.WriteLine("任务已取消");
        }
    }

    static async Task IncorrectAsyncWork()
    {
        // 未检查CancellationToken
        await Task.Delay(5000);
        Console.WriteLine("任务完成（但未响应取消）");
    }
}

修复方案：在异步方法中正确传递并检查CancellationToken。

using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var cts = new CancellationTokenSource();
        CancellationToken token = cts.Token;

        Task task = Task.Run(() => CorrectAsyncWork(token), token);

        await Task.Delay(2000);
        cts.Cancel();

        try
        {
            await task;
        }
        catch (OperationCanceledException)
        {
            Console.WriteLine("任务已取消");
        }
    }

    static async Task CorrectAsyncWork(CancellationToken token)
    {
        await Task.Delay(TimeSpan.FromSeconds(5), token);
        Console.WriteLine("任务完成（已响应取消）");
    }
}

关键注释：修改后的CorrectAsyncWork方法在Task.Delay中传递CancellationToken，使其能够响应取消请求。

五、性能对比/实践建议

性能对比：CancellationToken本身的开销极小，主要性能影响在于任务检查取消请求的频率。过于频繁检查可能增加额外开销，而检查过少可能导致响应取消不及时。
实践建议
- 合理设置检查频率：在性能和响应性之间找到平衡，对于计算密集型任务，可适当减少检查频率；对于I/O密集型任务，增加检查频率影响不大。
- 正确传递令牌：确保在整个调用链中正确传递CancellationToken，避免遗漏。
- 异常处理：在捕获OperationCanceledException时，应做好资源清理等善后工作。

六、常见问题解答

多个任务可以共享同一个CancellationToken吗？：可以，多个任务共享同一个CancellationToken时，任何一个任务收到取消信号都会取消所有相关任务，适合需要整体取消的场景。
如何在同步方法中使用CancellationToken？：虽然同步方法没有原生支持，但可以通过token.Register注册回调方法，在取消时执行相应逻辑。

CancellationToken为.NET开发者提供了一种优雅、高效的取消机制。核心要点在于协作式取消的理解和正确使用方式。适用于任何需要控制任务生命周期的场景，但不适合用于立即强制终止任务。随着.NET发展，预计会进一步优化取消机制在复杂场景下的易用性和性能。

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2026-06-16，如有侵权请联系 cloudcommunity@tencent.com 删除

性能