C# WinForm中如何点击停止按钮终止UI线程上的耗时任务

核心使用CancellationTokenSource作为终止信号，配合异步任务实现后台运行+安全终止，UI更新采用IProgress<T>实现跨线程安全更新，无需使用Thread.Abort这类不安全API。

实现步骤 #

• 窗体类全局声明CancellationTokenSource类型变量，用于发送停止信号
• Start按钮点击事件标记为async void（仅事件场景允许使用async void，其他异步方法统一用async Task），耗时逻辑封装到Task.Run中，同时传入取消令牌
• 耗时逻辑的循环/可中断节点判断取消标记是否触发，触发后立即终止执行
• 后台逻辑中的UI更新通过Progress<T>回调实现，回调自动在UI线程执行，避免跨线程访问异常
• Stop按钮点击事件中调用CancellationTokenSource的Cancel()方法发送终止信号

完整代码示例 #

// 窗体类全局声明取消令牌源
private CancellationTokenSource _cts;

// Start按钮点击事件
private async void btnStart_Click(object sender, EventArgs e)
{
    // 每次启动前实例化新的取消令牌源
    _cts = new CancellationTokenSource();
    // 启动时禁用Start按钮避免重复点击
    btnStart.Enabled = false;
    btnStop.Enabled = true;

    try
    {
        // Progress回调默认在UI线程执行，直接更新控件不会报错
        var progress = new Progress<string>(msg =>
        {
            txtLog.Text += msg + Environment.NewLine;
        });

        // 耗时逻辑放入后台任务运行
        await Task.Run(() =>
        {
            // 示例：循环执行的耗时逻辑，可替换为你的实际业务代码
            for (int i = 0; i < 1000; i++)
            {
                // 可中断节点判断是否收到取消信号，收到则抛出取消异常终止任务
                _cts.Token.ThrowIfCancellationRequested();

                // 模拟耗时操作，实际场景替换为你的业务逻辑
                Thread.Sleep(100);

                // 通过Progress回调更新UI
                progress.Report($"当前执行到第{i}步");
            }
        }, _cts.Token);
    }
    catch (OperationCanceledException)
    {
        // 取消属于正常业务逻辑，无需抛出异常，可直接更新终止提示
        txtLog.Text += "任务已被用户终止" + Environment.NewLine;
    }
    finally
    {
        // 任务结束/终止后恢复按钮状态，释放资源
        btnStart.Enabled = true;
        btnStop.Enabled = false;
        _cts.Dispose();
    }
}

// Stop按钮点击事件
private void btnStop_Click(object sender, EventArgs e)
{
    // 发送取消信号
    _cts?.Cancel();
}

关键说明 #

• 取消逻辑是协作式的，不是强制终止线程，需要在你自己的耗时逻辑的所有可中断节点添加_cts.Token.ThrowIfCancellationRequested()判断，比如循环每一轮、子方法调用前等。如果耗时逻辑依赖不支持取消的第三方API，只能在API调用前后加判断，无法中途打断该API的执行
• Progress<T>的回调默认在创建它的线程（也就是UI线程）执行，直接更新所有UI控件都不会触发跨线程访问错误，比手动调用控件Invoke方法更简洁
• 完全不需要用到Thread.Abort/Thread.Interrupt这类不安全的API，不会出现资源泄漏、程序状态异常的问题

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