BackgroundWorker使用总结

查询了一下MSDN文档,其中微软就BackgroundWorker类的功能有这么一个描述(英文的,根据我的理解翻译):BackgroundWorker类容许您在单独的线程上执行某个可能致使用户界面(UI)中止响应的耗时操做(好比文件下载数据库事务等),而且想要一个响应式的UI来反应当前耗时操做的进度。 
能够看的出来,BackgroundWorker组件提供了一种执行异步操做(后台线程)的同时,而且还能妥妥的显示操做进度的解决方案。因而乎,我便深刻的了解了一下BackgroundWorker类。针对BackgroundWorker类的部分重要属性和方法进行了一次总结。 javascript

一、属性:

  • WorkerReportsProgress 
    bool类型,指示BackgroundWorker是否能够报告进度更新。当该属性值为True是,将能够成功调用ReportProgress方法,不然将引起InvalidOperationException异常。 用法:
private BackgroundWorker bgWorker = new BackgroundWorker();
bgWorker.WorkerReportsProgress = true;
  • WorkerSupportsCancellation 
    bool类型,指示BackgroundWorker是否支持异步取消操做。当该属性值为True是,将能够成功调用CancelAsync方法,不然将引起InvalidOperationException异常。 用法:
bgWorker.WorkerSupportsCancellation = true;
  • CancellationPending 
    bool类型,指示应用程序是否已请求取消后台操做。此属性一般放在用户执行的异步操做内部,用来判断用户是否取消执行异步操做。当执行BackgroundWorker.CancelAsync()方法时,该属性值将变为True。 用法:
        public void bgWorker_DoWork(object sender, DoWorkEventArgs e)
        {
            for (int i = 0; i <= 100; i++)
            {
                if (bgWorker.CancellationPending)
                {
                    e.Cancel = true;
                    return;
                }
                else
                {
                    bgWorker.ReportProgress(i,"Working");
                    System.Threading.Thread.Sleep(10);
                }
            }
        }
  • IsBusy 
    bool类型,指示BackgroundWorker是否正在执行一个异步操做。此属性一般放在BackgroundWorker.RunWorkerAsync()方法以前,避免屡次调用RunWorkerAsync()方法引起异常。当执行BackgroundWorker.RunWorkerAsync()方法是,该属性值将变为True。
//防止重复执行异步操做引起错误
if (bgWorker.IsBusy)
    return;
bgWorker.RunWorkerAsync();

 

二、方法:

  • RunWorkerAsync() 
    开始执行一个后台操做。调用该方法后,将触发BackgroundWorker.DoWork事件,并以异步的方式执行DoWork事件中的代码。 
    该方法还有一个带参数的重载方法:RunWorkerAsync(Object)。该方法容许传递一个Object类型的参数到后台操做中,而且能够经过DoWork事件的DoWorkEventArgs.Argument属性将该参数提取出来。 
    注:当BackgroundWorker的IsBusy属性为True时,调用该方法将引起InvalidOperationException异常。
//在启动异步操做的地方键入代码
bgWorker.RunWorkerAsync("hello");
  • ReportProgress(Int percentProgress) 
    报告操做进度。调用该方法后,将触发BackgroundWorker. ProgressChanged事件。另外,该方法包含了一个int类型的参数percentProgress,用来表示当前异步操做所执行的进度百分比。 
    该方法还有一个重载方法:ReportProgress(Int percentProgress, Object userState)。容许传递一个Object类型的状态对象到 ProgressChanged事件中,而且能够经过ProgressChanged事件的ProgressChangedEventArgs.UserState属性取得参数值。 
    注:调用该方法以前需确保WorkerReportsProgress属性值为True,不然将引起InvalidOperationException异常。 
    用法:
        public void bgWorker_DoWork(object sender, DoWorkEventArgs e)
        {
            for (int i = 0; i <= 100; i++)
            {
                if (bgWorker.CancellationPending)
                {
                    e.Cancel = true;
                    return;
                }
                else
                {
                    //向ProgressChanged报告进度
                    bgWorker.ReportProgress(i,"Working");
                    System.Threading.Thread.Sleep(10);
                }
            }
        }
  • CancelAsync() 
    请求取消当前正在执行的异步操做。调用该方法将使BackgroundWorker.CancellationPending属性设置为True。 
    但须要注意的是,并不是每次调用CancelAsync()都能确保异步操做,CancelAsync()一般不适用于取消一个紧密执行的操做,更适用于在循环体中执行。 
    用法:
//在须要执行取消操做的地方键入如下代码
bgWorker.CancelAsync();

 

三、事件:

  • DoWork 
    用于承载异步操做。当调用BackgroundWorker.RunWorkerAsync()时触发。 
    须要注意的是,因为DoWork事件内部的代码运行在非UI线程之上,因此在DoWork事件内部应避免于用户界面交互,而于用户界面交互的操做应放置在ProgressChanged和RunWorkerCompleted事件中。html

  • ProgressChanged 
    当调用BackgroundWorker.ReportProgress(int percentProgress)方式时触发该事件。 
    该事件的ProgressChangedEventArgs.ProgressPercentage属性能够接收来自ReportProgress方法传递的percentProgress参数值,ProgressChangedEventArgs.UserState属性能够接收来自ReportProgress方法传递的userState参数。java

  • RunWorkerCompleted 
    异步操做完成或取消时执行的操做,当调用DoWork事件执行完成时触发。 
    该事件的RunWorkerCompletedEventArgs参数包含三个经常使用的属性Error,Cancelled,Result。其中,Error表示在执行异步操做期间发生的错误;Cancelled用于判断用户是否取消了异步操做;Result属性接收来自DoWork事件的DoWorkEventArgs参数的Result属性值,可用于传递异步操做的执行结果。数据库

四、附源代码:

前台异步

这里写图片描述

后台post

复制代码
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace PrograssBar
{
    public partial class PrograssBarUseBackgroundWorker : Form
    {

        private BackgroundWorker bgWorker = new BackgroundWorker();

        public PrograssBarUseBackgroundWorker()
        {
            InitializeComponent();
            InitializeBackgroundWorker();
        }

        private void InitializeBackgroundWorker()
        {
            bgWorker.WorkerReportsProgress = true;
            bgWorker.WorkerSupportsCancellation = true;
            bgWorker.DoWork += new DoWorkEventHandler(bgWorker_DoWork);
            bgWorker.ProgressChanged += new ProgressChangedEventHandler(bgWorker_ProgessChanged);
            bgWorker.RunWorkerCompleted += new RunWorkerCompletedEventHandler(bgWorker_WorkerCompleted);
        }

        private void btnStart_Click(object sender, EventArgs e)
        {
            if (bgWorker.IsBusy)
                return;
            this.progressBar1.Maximum = 100;
            this.btnStart.Enabled = false;
            this.btnStop.Enabled = true;
            bgWorker.RunWorkerAsync("hello");
        }

        public void bgWorker_DoWork(object sender, DoWorkEventArgs e)
        {
            for (int i = 0; i <= 100; i++)
            {
                if (bgWorker.CancellationPending)
                {
                    e.Cancel = true;
                    return;
                }
                else
                {
                    bgWorker.ReportProgress(i,"Working");
                    System.Threading.Thread.Sleep(10);
                }
            }
        }

        public void bgWorker_ProgessChanged(object sender, ProgressChangedEventArgs e)
        {
            //string state = (string)e.UserState;//接收ReportProgress方法传递过来的userState
            this.progressBar1.Value = e.ProgressPercentage;
            this.label1.Text = "处理进度:" + Convert.ToString(e.ProgressPercentage) + "%";
        }

        public void bgWorker_WorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
        {
            if(e.Error!=null)
            {
                MessageBox.Show(e.Error.ToString());
                return;
            }
            if (!e.Cancelled)
                this.label1.Text = "处理完毕!";
            else
                this.label1.Text = "处理终止!";

        }

        private void btnStop_Click(object sender, EventArgs e)
        {
            this.btnStart.Enabled = true;
            this.btnStop.Enabled = false;
            bgWorker.CancelAsync();
        }
    }
}
复制代码

运行结果:this

这里写图片描述

 

出处:http://www.javashuo.com/article/p-hglzfawo-hs.htmlspa

相关文章
相关标签/搜索