如何从嵌套的SecondBGW后台线程更新WinForms进度条

问题说明 #

在WinForms应用中，主UI线程创建了backgroundWorker1，而backgroundWorker1的执行逻辑里又创建了用于文件复制的SecondBGW后台线程。目前能通过backgroundWorker1的ProgressChanged或RunWorkerCompleted事件更新UI，但不知道如何从SecondBGW更新UI上的progressBar1进度条。

解决方案思路 #

核心是让SecondBGW的进度信息传递到主UI线程的backgroundWorker1，利用backgroundWorker1已有的ProgressChanged事件（该事件自动在UI线程触发）来更新进度条。以下是两种常用实现方式：

方式一：传递主BackgroundWorker引用 #

将主UI的backgroundWorker1引用传递给FirstClass，让SecondBGW的进度通过主backgroundWorker1报告到UI。

修改后的代码示例

1. Form1部分

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
        backgroundWorker1.WorkerReportsProgress = true;
        backgroundWorker1.WorkerSupportsCancellation = true;
    }

    private void startAsyncButton_Click(object sender, EventArgs e)
    {
        if (backgroundWorker1.IsBusy != true)
        {
            backgroundWorker1.RunWorkerAsync();
        }
    }

    private void cancelAsyncButton_Click(object sender, EventArgs e)
    {
        if (backgroundWorker1.WorkerSupportsCancellation == true)
        {
            backgroundWorker1.CancelAsync();
            progressBar1.Value = 0;
            resultLabel.Text = string.Empty;
        }
    }

    private void backgroundWorker1_DoWork(object sender, DoWorkEventArgs e)
    {
        // 将主BackgroundWorker引用传递给FirstClass
        FirstClass fs = new FirstClass((BackgroundWorker)sender);
        fs.Go();
    }

    private void backgroundWorker1_ProgressChanged(object sender, ProgressChangedEventArgs e)
    {
        resultLabel.Text = (e.ProgressPercentage.ToString() + "%");
        progressBar1.Value = e.ProgressPercentage;
    }
}

2. FirstClass部分

internal class FirstClass
{
    BackgroundWorker SecondBGW = new BackgroundWorker();
    private BackgroundWorker _mainBackgroundWorker;

    // 接收主BackgroundWorker引用
    public FirstClass(BackgroundWorker mainBGW)
    {
        _mainBackgroundWorker = mainBGW;
        SetSecondBGW();
    }

    private void SetSecondBGW()
    {
        SecondBGW.WorkerReportsProgress = true;
        SecondBGW.ProgressChanged += SecondBGW_ProgressChanged;
        SecondBGW.DoWork += SecondBGW_DoWork;
        // 同步取消状态：主BGW取消时，SecondBGW也取消
        SecondBGW.WorkerSupportsCancellation = true;
    }

    public void Go()
    {
        SecondBGW.RunWorkerAsync();
    }

    private void SecondBGW_DoWork(object? sender, DoWorkEventArgs e)
    {
        BackgroundWorker worker = sender as BackgroundWorker;
        for (int i = 1; i <= 10; i++)
        {
            // 检查取消请求
            if (worker.CancellationPending || _mainBackgroundWorker.CancellationPending)
            {
                e.Cancel = true;
                return;
            }
        }

        SecondClass sc = new SecondClass();
        sc.CopyFiles(SecondBGW, e);
    }

    private void SecondBGW_ProgressChanged(object? sender, ProgressChangedEventArgs e)
    {
        // 通过主BackgroundWorker将进度报告到UI线程
        if (!_mainBackgroundWorker.CancellationPending)
        {
            _mainBackgroundWorker.ReportProgress(e.ProgressPercentage);
        }
    }
}

3. SecondClass部分（无需修改）

internal class SecondClass
{
    public void CopyFiles(BackgroundWorker worker, DoWorkEventArgs e)
    {
        int numOfFiles = 100;

        for (int i = 1; i <= numOfFiles; i++)
        {
            // 检查取消请求
            if (worker.CancellationPending)
            {
                e.Cancel = true;
                return;
            }

            // 模拟文件复制操作
            System.Threading.Thread.Sleep(50);

            // 报告进度
            worker.ReportProgress(i);
        }
    }
}

方式二：传递进度回调委托 #

如果不想直接传递主BackgroundWorker引用，可以定义Action<int>类型的回调委托，将UI线程的进度更新逻辑传递下去。

关键修改示例

1. Form1的DoWork事件

private void backgroundWorker1_DoWork(object sender, DoWorkEventArgs e)
{
    // 传递进度更新回调
    FirstClass fs = new FirstClass(progress => 
    {
        ((BackgroundWorker)sender).ReportProgress(progress);
    });
    fs.Go();
}

2. FirstClass的构造函数和ProgressChanged事件

internal class FirstClass
{
    BackgroundWorker SecondBGW = new BackgroundWorker();
    private Action<int> _progressCallback;

    public FirstClass(Action<int> progressCallback)
    {
        _progressCallback = progressCallback;
        SetSecondBGW();
    }

    private void SecondBGW_ProgressChanged(object? sender, ProgressChangedEventArgs e)
    {
        _progressCallback.Invoke(e.ProgressPercentage);
    }
}

注意事项 #

• 务必在SecondBGW的DoWork事件中检查取消请求（包括主backgroundWorker1的CancellationPending状态），避免线程无法终止。
• BackgroundWorker的ProgressChanged事件默认在UI线程触发，无需额外调用Control.Invoke或Control.BeginInvoke。

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