WinForms中使用BackgroundWorker实现多线程方法及动态控件操作

我来一步步帮你搞定这个需求，咱们从代码结构到细节都讲清楚，确保每一步都符合WinForms的线程安全规范：

1. 主窗体基础准备 #

首先，你的主窗体（比如Form1）上先放一个Button（命名为btnStartTask）用来触发任务。然后咱们在代码里实现点击事件的逻辑：

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
        btnStartTask.Click += BtnStartTask_Click;
    }

    private void BtnStartTask_Click(object sender, EventArgs e)
    {
        // 1. 创建并添加新的ProgressBar
        var progressBar = new ProgressBar();
        progressBar.Width = this.ClientSize.Width - 40;
        progressBar.Height = 25;
        // 位置：第一个从顶部40开始，之后每个往下挪30像素
        int topPosition = 40 + (this.Controls.OfType<ProgressBar>().Count() * 30);
        progressBar.Location = new Point(20, topPosition);
        this.Controls.Add(progressBar);

        // 2. 创建要处理的Bitmap（尺寸可以自己调整）
        int bitmapWidth = 800;
        int bitmapHeight = 600;
        var bitmap = new Bitmap(bitmapWidth, bitmapHeight);

        // 3. 初始化BackgroundWorker
        var worker = new BackgroundWorker();
        worker.WorkerReportsProgress = true; // 允许报告进度
        worker.WorkerSupportsCancellation = false; // 这里不需要取消功能
        // 绑定核心事件
        worker.DoWork += Worker_DoWork;
        worker.ProgressChanged += Worker_ProgressChanged;
        worker.RunWorkerCompleted += Worker_RunWorkerCompleted;

        // 把Bitmap和ProgressBar作为参数传给后台任务
        worker.RunWorkerAsync(new Tuple<Bitmap, ProgressBar>(bitmap, progressBar));
    }
}

2. 后台处理像素（DoWork事件） #

这个事件在后台线程执行，绝对不能直接操作UI控件！咱们在这里循环处理每个像素，计算进度并报告：

private void Worker_DoWork(object sender, DoWorkEventArgs e)
{
    // 取出传入的Bitmap和ProgressBar
    var tuple = e.Argument as Tuple<Bitmap, ProgressBar>;
    Bitmap bitmap = tuple.Item1;
    int totalPixels = bitmap.Width * bitmap.Height;
    int processedPixels = 0;

    // 循环处理每个像素（这里用蓝红渐变举例，你可以换成自己的颜色逻辑）
    for (int y = 0; y < bitmap.Height; y++)
    {
        for (int x = 0; x < bitmap.Width; x++)
        {
            int red = (int)((float)x / bitmap.Width * 255);
            int blue = 255 - red;
            Color pixelColor = Color.FromArgb(255, red, 0, blue);
            bitmap.SetPixel(x, y, pixelColor);

            processedPixels++;
            // 每处理1000个像素报告一次进度（避免频繁更新UI导致卡顿）
            if (processedPixels % 1000 == 0)
            {
                int progressPercentage = (int)((float)processedPixels / totalPixels * 100);
                (sender as BackgroundWorker).ReportProgress(progressPercentage, tuple.Item2);
            }
        }
    }

    // 把处理好的Bitmap作为结果返回给收尾事件
    e.Result = bitmap;
}

3. 更新进度条（ProgressChanged事件） #

这个事件在UI线程执行，所以可以安全操作ProgressBar：

private void Worker_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
    var progressBar = e.UserState as ProgressBar;
    if (progressBar != null && progressBar.IsHandleCreated)
    {
        progressBar.Value = e.ProgressPercentage;
        progressBar.Refresh(); // 强制刷新显示最新进度
    }
}

4. 任务完成后的收尾（RunWorkerCompleted事件） #

同样在UI线程执行，我们创建新窗体显示Bitmap，然后移除并释放ProgressBar资源：

private void Worker_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{
    var worker = sender as BackgroundWorker;
    var taskTuple = worker.Argument as Tuple<Bitmap, ProgressBar>;

    // 处理异常情况
    if (e.Error != null)
    {
        MessageBox.Show($"处理出错：{e.Error.Message}");
        CleanupResources(taskTuple?.Item2, worker);
        return;
    }

    // 取出处理好的Bitmap并创建新窗体
    Bitmap processedBitmap = e.Result as Bitmap;
    if (processedBitmap != null)
    {
        var resultForm = new Form();
        resultForm.Size = processedBitmap.Size;
        resultForm.BackgroundImage = processedBitmap;
        resultForm.BackgroundImageLayout = ImageLayout.Stretch;
        resultForm.Show();
    }

    // 清理资源
    CleanupResources(taskTuple?.Item2, worker);
}

// 封装资源清理逻辑，避免重复代码
private void CleanupResources(ProgressBar progressBar, BackgroundWorker worker)
{
    if (progressBar != null)
    {
        this.Controls.Remove(progressBar);
        progressBar.Dispose();
    }
    worker?.Dispose();
}

关键注意点 #

• 线程安全：WinForms控件只能在创建它的UI线程操作，所有UI更新必须放在ProgressChanged或RunWorkerCompleted事件里，绝对不能在DoWork里直接操作控件！
• 资源释放：记得用完ProgressBar、BackgroundWorker后调用Dispose()，避免内存泄漏。
• 进度报告频率：不要每处理一个像素就报告一次，太频繁会导致UI卡顿，这里设置每1000个像素报告一次，你可以根据Bitmap尺寸调整。

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