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;
        }
    }
}