winform多线程组件BackgroundWorker使用

时间：2022-09-12 10:14:35|栏目：.NET代码|点击：次

BackgroundWorker是·net里用来执行多线程任务的控件，它允许编程者在一个单独的线程上执行一些操作。

可以通过编程方式创建 BackgroundWorker，也可以将它从“工具箱”的“组件”选项卡中拖到窗体上。如果在 Windows 窗体设计器中创建 BackgroundWorker，则它会出现在组件栏中，而且它的属性会显示在“属性”窗口中。

常用方法

RunWorkerAsync 开始执行后台操作。引发 DoWork 事件。
　　　public void RunWorkerAsync(); //启动线程，触发DoWork事件
　　　public void RunWorkerAsync(object argument);
CancelAsync 请求取消挂起的后台操作。
注意：这个方法是将 CancellationPending 属性设置为 true，并不会终止后台操作。在后台操作中要检查CancellationPending 属性，来决定是否要继续执行耗时的操作。
ReportProgress引发 ProgressChanged 事件。
　　　public void ReportProgress(int percentProgress); //报告进度，触发ProgressChanged事件
　　　public void ReportProgress(int percentProgress, object userState);

常用属性

IsBusy： //只读属性，用来判断当前线程是否正在工作中。
CancellationPending：指示应用程序是否已请求取消后台操作。只读属性，默认为 false，当执行了 CancelAsync 方法后，值为 true。
WorkerSupportsCancellation：指示是否支持异步取消。要执行 CancelAsync 方法，需要先设置该属性为 true。
WorkerReportsProgress：指示是否能报告进度。要执行 ReportProgress 方法，需要先设置该属性为 true。

常用事件

DoWork: 调用 RunWorkerAsync 方法时发生。
ProgressChanged：可选，调用 ReportProgress 方法时发生。
RunWorkerCompleted:可选，后台操作已完成、被取消或引发异常时发生。

注意：在 DoWork 事件处理程序中不操作任何用户界面对象。而应该通过 ProgressChanged 和RunWorkerCompleted 事件与用户界面进行通信。

如果想在 DoWork 事件处理程序中和用户界面的控件通信，可在用 ReportProgress 方法。ReportProgress（int percentProgress, object userState），可以传递一个对象。ProgressChanged 事件可以从参数ProgressChangedEventArgs 类的UserState 属性得到这个信息对象。这个事件也可以实现进度条功能，把任务的进度实时呈现给用户。

简单的程序用BackgroundWorker 比 Thread 方便，Thread中和用户界面上的控件通信比较麻烦，需要用委托来调用控件的 Invoke 或BeginInvoke 方法，没有 BackgroundWorker 方便。

使用backgroundWorker步骤

新建BackgroundWorder对象；
根据需求, 设置是否能取消(WorkerSupportsCancellation)、是否报告进度(WorkerReportsProgress);
根据需求，设置好相关事件，DoWorker、ProgressChanged、ProgressChanged；
调用RunWorkerAsyns()方法，启动线程；
在需要取消的位置，判断CancellationPending的值，并做相关处理；//可选
在适当的位置调用ReportProgress(int percentProgress)方法，报告进度。

BackgroundWorker实例

    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();

            backgroundWorker1.WorkerReportsProgress = true;//报告完成进度
            backgroundWorker1.WorkerSupportsCancellation = true;//允许用户终止后台线程
                                                                //绑定事件
            backgroundWorker1.DoWork += new DoWorkEventHandler(backgroundWorker1_DoWork);
            backgroundWorker1.ProgressChanged += new ProgressChangedEventHandler(backgroundWorker1_ProgressChanged);
            backgroundWorker1.RunWorkerCompleted += new RunWorkerCompletedEventHandler(backgroundWorker1_RunWorkerCompleted);

        }
        //开始按钮
        private void button1_Click(object sender, EventArgs e)
        {
            if (!backgroundWorker1.IsBusy)//判断backgroundWorker1是否正在运行异步操作
            {
                backgroundWorker1.RunWorkerAsync(1000);//开始执行后台异步操作，调用DoWork事件
            }
            while (backgroundWorker1.IsBusy)//等待后台运行完毕
            {
                Application.DoEvents();
            }
            MessageBox.Show("操作完成");
        }

        //取消按钮
        private void button2_Click(object sender, EventArgs e)
        {
            if (backgroundWorker1.WorkerSupportsCancellation == true)
            {
                backgroundWorker1.CancelAsync();//取消后台操作
                backgroundWorker1.Dispose();//释放资源
            }
        }

        //DoWork事件声明要执行的耗时操作
        private void backgroundWorker1_DoWork(object sender, DoWorkEventArgs e)
        {
            BackgroundWorker backgroundWorker = sender as BackgroundWorker;
            e.Result = ListNumber(backgroundWorker, e);//运算结果保存在e.Result中(在RunWorkerCompleted事件可能会使用到)
        }

        bool ListNumber(object sender, DoWorkEventArgs e)
        {
            int num = (int)e.Argument;//接收传入的参数,即RunWorkerAsync(object argument)传入的值
            for (int i = 1; i <= num; i++)
            {
                if (backgroundWorker1.CancellationPending)//判断是否请求了取消后台操作,如果为false则退出
                {
                    e.Cancel = true;//e.Cancel 是否应该取消事件
                    return false;
                }
                Thread.Sleep(10);//执行一个耗时操作
                backgroundWorker1.ReportProgress(i * 100 / num, i);//报告完成进度

            }
            return true;
        }

        private void backgroundWorker1_ProgressChanged(object sender, ProgressChangedEventArgs e)
        {

            progressBar1.Value = e.ProgressPercentage;//将完成进度数据传给进度条
            label1.Text = e.ProgressPercentage + "%";
            //将中间计算结果在ListBox控件中显示出来
            listBox1.Items.Add(e.UserState);//接收ReportProgress方法传递过来的userState
        }

        private void backgroundWorker1_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
        {
            if (e.Cancelled == true) //e.Cancelled指示异步操作是否已被取消
            {
                MessageBox.Show("Canceled!");
            }
            else if (e.Error != null) //e.Error 指示异步操作期间发生的错误
            {
                MessageBox.Show("Error: " + e.Error.Message);
            }
            else
            {
                MessageBox.Show(e.Result.ToString());  //e.Result 获取异步操作结果的值,即DoWork事件中，Result设置的值。
            }

        }
    }

对Winform窗体控件进行安全调用

（WinForm中实现多线程的首选方法是backgroundWorker)

Thread thread = new Thread(SetLabel);//另开一个线程上设置Label的属性
thread.Start();
 
delegate void Action(string args);//Net3.5自带的Action无参数无返回值
private void SetLabel()
{
    Action action = delegate (string args)
    {
        this.label1.Text = args;
    };
    if (this.InvokeRequired)//判断当前代码是运行于创建该控件的线程之上，还是运行于另一个线程之上。
        this.Invoke(action, "XXX");//注意控件的Inovoke和BeginInvoke委托的方法都执行在UI线程上。对Control的Invoke方法可以使用一个简单的系统委托MethodInvoker无参数返回Void调用。
    else
        action("XXX");
}

上一篇：C#实现提取Word中插入的多媒体文件(视频,音频)

栏目：.NET代码

下一篇：C#实现斐波那契数列的几种方法整理

本文标题：winform多线程组件BackgroundWorker使用

本文地址：http://www.codeinn.net/misctech/213445.html

更多.NET代码

.NET代码