c# BackgroundWorker控件使用方法

在使用之前先了解一些知识。  1、BackgroundWorker作用：      主要用在单独的线程上执行操作。  BackgroundWorker类允许您在单独的专用线程上运行操作。 耗时的操作（如下载和数据库事务）在长时间运行时可能会导致用户界面(UI) 似乎处于停止响应状态。 如果您需要能进行响应的用户界面，而且面临与这类操作相关的长时间延迟，则可以使用BackgroundWorker类方便地解决问题。  2、BackgroundWorker常用属性： 

名称	说明
CancellationPending	指示应用程式是否已请求取消后台操作即(是否正在停止中)。
IsBusy	获取一个值，指示BackgroundWorker 是否正在运行非同步操作。
WorkerReportsProgress	该值指示BackgroundWorker 能否报告进度更新。
WorkerSupportsCancellation	该值指示BackgroundWorker 是否支援非同步取消。

3、BackgroundWorker常用事件： 

控制项	名称	说明
TextBox	txtSelect	用于显示被选择文件的路径
Button	btnSelectFile	用于选择文件
TextBox	txtResult	用于显示后台程式执行的结果
ProgressBar	pgbValue	用于显示背景程式执行的结果
Button	btnRun	用于执行背景程式
Button	btnCancel	用于取消正在执行的背景程式
BackgroundWorker	bgwWorker	用于后台运行程式

4、注意：              运行RunWorkerAsync()方法会触发DoWork事件              运行ReportProgress()方法会触发ProgressChanged事件  5、使用过程：        5.1 在窗体中加入控件  5.2 加入BackgroundWorker的事件  5.3 在DoWork事件的方法中调用需要执行的方法  5.4 在ProgressChanged事件的方法中显示进度  5.5 在RunWorkerCompleted事件的方法中显示被执行方法的结果  6、代码：      6.1 代码中的控件说明： 

控件	名称	说明
TextBox	txtSelect	用于显示被选择文件的路径
Button	btnSelectFile	用于选择文件
TextBox	txtResult	用于显示后台程序执行的结果
ProgressBar	pgbValue	用于显示背景程序执行的结果
Button	btnRun	用于执行背景程序
Button	btnCancel	用于取消正在执行的背景程序

    6.2代码(下面代码作用是将文件转成swf)：

using System.ComponentModel;
using System.IO;

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

            //“執行背景程序”按鈕事件
            btnRun.Click += new EventHandler(btnRun_Click);
            //“取消背景程序”按鈕事件
            btnCancel.Click += new EventHandler(btnCancel_Click);

            //是否允許BackgroundWorker 能否报告进度
            bgwWorker.WorkerReportsProgress = true;

            //選擇文件按鈕方法
            btnSelectFile.Click += new EventHandler(btnSelectFile_Click);


            //5.2
            //开始执行后台操作時
            //当执行BackgroundWorker.RunWorkerAsync方法时会触发该事件，并且传递DoWorkEventArgs参数;
            bgwWorker.DoWork += new DoWorkEventHandler(bgwWorker_DoWork);
            //引发 ProgressChanged 事件。 ProgressChanged是负责报告当前程序进度
            bgwWorker.ProgressChanged += new ProgressChangedEventHandler(bgwWorker_ProgressChanged);
            //当后台操作已完成、被取消或引发异常时发生。
            bgwWorker.RunWorkerCompleted += new RunWorkerCompletedEventHandler(bgwWorker_RunWorkerCompleted);
                  
        }

        /// <summary>
        /// 被選擇的文件
        /// </summary>
        string sFile = "";

        /// <summary>
        /// ProgressBar的值
        /// </summary>
        int iProgressValue = 1;


        String fs_filename = "";
        /// <summary>
        /// 得到轉換后文件在服務器的絕對路徑
        /// </summary>
        String fs_convertedfilename = "";

        /// <summary>
        /// 得到選項選擇的結果(0為瀏覽)
        /// </summary>
        int interfaceOptions = 0;

        /// <summary>
        /// 選擇文件
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        void btnSelectFile_Click(object sender, EventArgs e)
        {
            //選擇文件
            OpenFileDialog ofdDialog = new OpenFileDialog();  
            if (ofdDialog.ShowDialog()==DialogResult.OK)
            {
                sFile = ofdDialog.FileName;           
                string sFilePathName = Path.GetDirectoryName(sFile) +"//"+ Path.GetFileNameWithoutExtension(sFile);
                txtSelect.Text = sFile;

                fs_filename = sFile;
                
                //得到轉換后的文件名
                fs_convertedfilename = sFilePathName + ".swf";
            }
        }

        /// <summary>
        /// “執行背景程序”按鈕事件的方法
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        void btnRun_Click(object sender, EventArgs e)
        {
            string sFile = "";
            //开始执行任务，會触发DoWork事件
            bgwWorker.RunWorkerAsync(sFile);
        }


        /// <summary>
        /// “取消背景程序”按鈕事件的方法
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        void btnCancel_Click(object sender, EventArgs e)
        {
            if (bgwWorker.IsBusy)
            {
                //取消操作
                bgwWorker.CancelAsync();
                txtResult.Text += "已取消";
            }
        }

 

        /// <summary>
        /// 开始执行后台操作時
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        void bgwWorker_DoWork(object sender, DoWorkEventArgs e)
        {
            BackgroundWorker bgwValue = (BackgroundWorker)sender;

            //報告進度(進度值需自己傳入)
            bgwWorker.ReportProgress(iProgressValue);

             //5.3
             //運行需要運行的方法。
             RunPrint2Falsh();
            if ( RunPrint2Falsh()==true)
            {
                bgwWorker.ReportProgress(100);
            }
        }

  
        /// <summary>
        /// 背景程序进度方法
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        void bgwWorker_ProgressChanged(object sender, ProgressChangedEventArgs e)
        {
            //5.4
            //設置ProgressBar設
            pgbValue.Value = e.ProgressPercentage;
  
        }

        /// <summary>
        /// 背景程序運行完成事件方法
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        void bgwWorker_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
        {
            //5.5
            txtResult.Text += "完成！";            
        }

        /// <summary>
        /// 運行將文件轉換成Flash程序(此處引用了Print2Flash控件)
        /// </summary>
        /// <returns></returns>
        private bool RunPrint2Falsh()
        {
            bool sRetrun = false;
            try
            {
                P2F.Server2 p2fServer = new P2F.Server2();
                p2fServer.DefaultProfile.InterfaceOptions = interfaceOptions;
                p2fServer.ConvertFile(fs_filename, fs_convertedfilename, null, null, null);
                sRetrun = true;
            }
            catch (Exception ex)
            {                
                throw ex;
            }
            return sRetrun;
        }
    }
}

来自：http://www.cnblogs.com/tom-tong/archive/2012/02/22/2363965.html

BackgroundWorker 可以用于启动后台线程。

主要的事件及参数：
　　1.DoWork——当执行BackgroundWorker.RunWorkerAsync方法时会触发该事件，并且传递DoWorkEventArgs参数;

　　2.RunWorkerCompleted——异步操作完成或中途终止会触发该事件。

如果需要提前终止执行后台操作，可以调用BackgroundWorker.CancelAsync方法。

在处理DoWork事件的函数中检测BackgroundWorker.CancellationPending属性是否为true，如果是true，则表示用户已经取消了异步调用，同时将DoWorkEventArgs.Cancel属性设为true(传递给处理DoWork事件的函数的第二个参数)，这样当退出异步调用的时候，可以让处理RunWorkerCompleted事件的函数知道是正常退出还是中途退出。
　　3.ProgressChanged——操作处理中获得的处理状态变化，通过BackgroundWorker.ReportProgress(int)方法触发该事件，并且传递ProgressChangedEventArgs,其中包含了处理的百分比,这个参数在UI界面上设置progressbar控件。   

   
 主要的方法：
         1. BackgroundWorker.RunWorkerAsync——“起动”异步调用的方法有两次重载RunWorkerAsync(),RunWorkerAsync(object argument)，第二个重载提供了一个参数，可以供异步调用使用。（如果有多个参数要传递怎么办，使用一个类来传递他们吧)。调用该方法后会触发DoWork事件，并且为处理DoWork事件的函数传递DoWorkEventArg参数，其中包含了RunWorkerAsync传递的参数。在相应DoWork的处理函数中就可以做具体的复杂操作。
        2. BackgroundWorker.ReportProgress——需要在一个冗长的操作中向用户不断反馈进度，这样的话就可以调用的ReportProgress(int percent),在调用 ReportProgress 方法时，触发ProgressChanged事件。提供一个在 0 到 100 之间的整数，它表示后台活动已完成的百分比。你也可以提供任何对象作为第二个参数，允许你 给事件处理程序传递状态信息。作为传递到此过程的 ProgressChangedEventArgs 参数属性，百分比和你自己的对象（如果提供的话）均要被传递到 ProgressChanged 事件处理程序。这些属性被分别命名为 ProgressPercentage 和 UserState，并且你的事件处理程序可以以任何需要的方式使用它们。(注意：只有在BackgroundWorker.WorkerReportsProgress属性被设置为true该方法才可用)。
        3. BackgroundWorker.CancelAsync——但需要退出异步调用的时候，就调用的这个方法。但是样还不够，因为它仅仅是将BackgroudWorker.CancellationPending属性设置为true。你需要在具体的异步调用处理的时候，不断检查BackgroudWorker.CancellationPending是否为true，如果是真的话就退出。(注意：只有在BackgroundWorker.WorkerSupportsCancellation属性被设置为true该方法才可用)。

 

BackgroundWorker组件
在VS2005中添加了BackgroundWorker组件，该组件在多线程编程方面使用起来非常方便，然而在开始时由于没有搞清楚它的使用机制，走了不少的弯路，现在把我在使用它的过程中的经验与诸位分享一下。
    BackgroundWorker类中主要用到的有这列属性、方法和事件：
    重要属性：
    1、CancellationPending             获取一个值，指示应用程序是否已请求取消后台操作。通过在DoWork事件中判断CancellationPending属性可以认定是否需要取消后台操作（也就是结束线程）；
    2、IsBusy                          获取一个值，指示 BackgroundWorker 是否正在运行异步操作。程序中使用IsBusy属性用来确定后台操作是否正在使用中；
    3、WorkerReportsProgress           获取或设置一个值，该值指示BackgroundWorker能否报告进度更新
    4、WorkerSupportsCancellation      获取或设置一个值，该值指示 BackgroundWorker 是否支持异步取消。设置WorkerSupportsCancellation为true使得程序可以调用CancelAsync方法提交终止挂起的后台操作的请求；
    重要方法：
    1、CancelAsync         请求取消挂起的后台操作
    2、RunWorkerAsync      开始执行后台操作
    3、ReportProgress      引发ProgressChanged事件  
    重要事件：
    1、DoWork              调用 RunWorkerAsync 时发生
    2、ProgressChanged     调用 ReportProgress 时发生
    3、RunWorkerCompleted  当后台操作已完成、被取消或引发异常时发生
    另外还有三个重要的参数是RunWorkerCompletedEventArgs以及DoWorkEventArgs、ProgressChangedEventArgs。
    BackgroundWorker的各属性、方法、事件的调用机制和顺序：

从上图可见在整个生活周期内发生了3次重要的参数传递过程：
    参数传递1：此次的参数传递是将RunWorkerAsync(Object)中的Object传递到DoWork事件的DoWorkEventArgs.Argument,由于在这里只有一个参数可以传递，所以在实际应用往封装一个类，将整个实例化的类作为RunWorkerAsync的Object传递到DoWorkEventArgs.Argument；
    参数传递2：此次是将程序运行进度传递给ProgressChanged事件，实际使用中往往使用给方法和事件更新进度条或者日志信息；
    参数传递3：在DoWork事件结束之前，将后台线程产生的结果数据赋给DoWorkEventArgs.Result一边在RunWorkerCompleted事件中调用RunWorkerCompletedEventArgs.Result属性取得后台线程产生的结果。
    另外从上图可以看到DoWork事件是在后台线程中运行的，所以在该事件中不能够操作用户界面的内容，如果需要更新用户界面，可以使用ProgressChanged事件及RunWorkCompleted事件来实现。


在WinForm中经常遇到一些费时的操作界面，比如统计某个磁盘分区的文件夹或者文件数目，如果分区很大或者文件过多的话，处理不好就会造成“假死”的情况，或者报“线程间操作无效”的异常，为了解决这个问题，可以使用委托来处理，在.net2.0中还可以用BackgroundWorker类。

BackgroundWorker类是.net 2.0里新增加的一个类，对于需要长时间操作而不需要用户长时间等待的情况可以使用这个类。
注意确保在 DoWork 事件处理程序中不操作任何用户界面对象。而应该通过 ProgressChanged 和 RunWorkerCompleted 事件与用户界面进行通信。 

 

 

可以将页面做为对象传入，也可以在DoWork中用 this.BeginInvoke(New MethodInvoke(delegate {来获取页面上的控件的值}));

 

public partial class MainWindow : Window 
    { 
  
        private BackgroundWorker m_BackgroundWorker;// 申明后台对象 
  
        public MainWindow() 
        { 
            InitializeComponent(); 
  
            m_BackgroundWorker = new BackgroundWorker(); // 实例化后台对象 
  
            m_BackgroundWorker.WorkerReportsProgress = true; // 设置可以通告进度 
            m_BackgroundWorker.WorkerSupportsCancellation = true; // 设置可以取消 
  
            m_BackgroundWorker.DoWork += new DoWorkEventHandler(DoWork); 
            m_BackgroundWorker.ProgressChanged += new ProgressChangedEventHandler(UpdateProgress); 
            m_BackgroundWorker.RunWorkerCompleted += new RunWorkerCompletedEventHandler(CompletedWork); 
  
            m_BackgroundWorker.RunWorkerAsync(this); 
        } 
  
  
        void DoWork(object sender, DoWorkEventArgs e) 
        { 
            BackgroundWorker bw = sender as BackgroundWorker; 
            MainWindow win = e.Argument as MainWindow; 
  
            int i = 0; 
            while ( i <= 100 ) 
            { 
                if (bw.CancellationPending) 
                { 
                    e.Cancel = true; 
                    break; 
                } 
  
                bw.ReportProgress(i++); 
      
                Thread.Sleep(1000); 
  
            } 
        } 
  
        void UpdateProgress(object sender, ProgressChangedEventArgs e) 
        { 
            int progress = e.ProgressPercentage; 
  
            label1.Content = string.Format("{0}",progress); 
        } 
  
  
        void CompletedWork(object sender, RunWorkerCompletedEventArgs e) 
        { 
            if ( e.Error != null) 
            { 
                MessageBox.Show("Error"); 
            } 
            else if (e.Cancelled) 
            { 
                MessageBox.Show("Canceled"); 
            } 
            else
            { 
                MessageBox.Show("Completed"); 
            } 
        } 
  
  
        private void button1_Click(object sender, RoutedEventArgs e) 
        { 
            m_BackgroundWorker.CancelAsync(); 
        } 
    }