

WinForm 中异步加载数据并使用进度条

DotNet技术匠

2025-09-06

导读：WinForm中异步加载数据并使用进度条。

前言

在开发WinForm应用程序时，经常会遇到需要加载大量数据的场景，比如读取文件、查询数据库或调用远程接口。如果这些操作直接在主线程中执行，UI界面就会出现"假死"现象——窗口无法响应用户的点击、拖动等操作，甚至可能显示"未响应"的提示。这种体验对用户来说非常不友好，容易让人误以为程序崩溃。

为了解决这个问题，我们需要将耗时操作放到后台线程中执行，同时通过进度条向用户反馈当前的处理进度。这样既能保证界面的流畅响应，又能提升用户的操作信心。

本文将介绍如何使用 .NET 提供的 BackgroundWorker 组件，实现数据的异步加载与进度可视化。

效果图

BackgroundWorker 的核心作用

BackgroundWorker 是 .NET Framework 中一个专为 WinForm 和 WPF 设计的异步操作组件，位于 System.ComponentModel 命名空间下。

它最大的优势在于：

支持在后台线程执行耗时任务
可以安全地向主线程报告进度
支持取消操作
能够捕获并转发异常
实现了 IComponent 接口，可以直接从 Visual Studio 工具箱拖拽到窗体上使用

这使得它成为处理 WinForm 中异步任务的首选工具之一，尤其适合初学者快速上手多线程编程。

完整实现步骤与代码解析

下面我们通过一个具体的例子，展示如何使用 BackgroundWorker 实现异步加载数据并显示进度条。

1、界面设计

在 WinForm 窗体中添加以下控件：

一个 ProgressBar（进度条）
一个"开始"按钮（startButton）
一个"取消"按钮（cancelButton）
一个 TextBox（resultTextBox，用于显示日志）
一个 BackgroundWorker 组件（命名为 bw）

然后设置 BackgroundWorker 的两个关键属性：

WorkerReportsProgress：设为 True，启用进度报告功能

WorkerSupportsCancellation：设为 True，启用取消功能

2、DoWork 事件：执行后台任务

该事件在后台线程中运行，用于执行耗时操作。

注意：此处不能直接操作 UI 控件。

private void bw_DoWork(object sender, DoWorkEventArgs e)
{
    var count = (int)e.Argument;
    for (int i = 1; i <= count; i++)
    {
        if (bw.CancellationPending)
        {
            e.Cancel = true;
            return;
        }
                    
        bw.ReportProgress(i);
        Thread.Sleep(200);      // 模拟耗时的任务
    }                          
}

关键点说明

e.Argument 可以接收 RunWorkerAsync() 传入的参数，在本例中是循环次数。

CancellationPending 用于检测用户是否点击了取消按钮。

ReportProgress(i) 用于向主线程报告当前进度，值为 i，将在 ProgressChanged 事件中接收。

3、ProgressChanged 事件：更新UI进度

该事件在主线程中执行，可以安全地操作 UI 控件。

private void bw_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
    progressBar.Value = e.ProgressPercentage;
    resultTextBox.Text += DateTime.Now + "\r\n";
}

e.ProgressPercentage 即为 ReportProgress() 方法传入的值，用于更新进度条的当前值。

4、RunWorkerCompleted 事件：任务完成处理

无论任务成功、取消还是抛出异常，都会进入此事件，适合进行收尾工作和异常处理。

private void bw_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{
    if (e.Cancelled)
        resultTextBox.Text += "任务取消。" + "\r\n";
    else if (e.Error != null)
        resultTextBox.Text += "出现异常: " + e.Error + "\r\n";
    else
        resultTextBox.Text += "任务完成。 " + "\r\n";
}

异常处理说明

如果 DoWork 中抛出异常，该异常不会直接中断程序，而是被封装到 e.Error 中，可以在本事件中捕获并提示用户。

5、启动与取消按钮的事件处理

private void startButton_Click(object sender, EventArgs e)
{
    progressBar.Value = 0;
    progressBar.Maximum = 10;

    resultTextBox.Text = "任务开始..." + "\r\n";
    bw.RunWorkerAsync(10);
}

点击"开始"按钮后，调用 RunWorkerAsync(10) 启动后台任务，并传入参数 10。

private void cancelbutton_Click(object sender, EventArgs e)
{
    bw.CancelAsync();
}

点击"取消"按钮后，调用 CancelAsync() 发起取消请求。注意：这只是一个"请求"，实际是否取消取决于 DoWork 中是否检查了 CancellationPending。

6、完整代码示例

public partialclassForm1 : Form
{
    public Form1()
    {
        InitializeComponent();
        bw.DoWork += bw_DoWork;
        bw.ProgressChanged += bw_ProgressChanged;
        bw.RunWorkerCompleted += bw_RunWorkerCompleted;
    }

    private void startButton_Click(object sender, EventArgs e)
    {
        progressBar.Value = 0;
        progressBar.Maximum = 10;

        resultTextBox.Text = "任务开始..." + "\r\n";
        bw.RunWorkerAsync(10);
    }

    private void bw_DoWork(object sender, DoWorkEventArgs e)
    {
        var count = (int)e.Argument;
        for (int i = 1; i <= count; i++)
        {
            if (bw.CancellationPending)
            {
                e.Cancel = true;
                return;
            }

            if (i == 2)
                thrownew Exception("出错啦！");
                    
            bw.ReportProgress(i);
            Thread.Sleep(200);      
        }                          
    }

    private void bw_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
    {
        if (e.Cancelled)
            resultTextBox.Text += "任务取消。" + "\r\n";
        elseif (e.Error != null)
            resultTextBox.Text += "出现异常: " + e.Error + "\r\n";
        else
            resultTextBox.Text += "任务完成。 " + "\r\n";
    }

    private void bw_ProgressChanged(object sender, ProgressChangedEventArgs e)
    {
        progressBar.Value = e.ProgressPercentage;
        resultTextBox.Text += DateTime.Now + "\r\n";
    }

    private void cancelbutton_Click(object sender, EventArgs e)
    {
        bw.CancelAsync();
    }
}