日本免费高清视频-国产福利视频导航-黄色在线播放国产-天天操天天操天天操天天操|www.shdianci.com

學無先后，達者為師

網站首頁 編程語言 正文

C#中BackgroundWorker類用法總結_C#教程

作者：五維思考 ? 更新時間： 2022-03-08 編程語言

查詢了一下MSDN文檔，其中微軟就BackgroundWorker類的功能有這么一個描述（英文的，根據個人理解翻譯）：BackgroundWorker類允許您在單獨的線程上執行某個可能導致用戶界面（UI）停止響應的耗時操作（比如文件下載數據庫事務等），并且想要一個響應式的UI來反應當前耗時操作的進度。?

可以看的出來，BackgroundWorker組件提供了一種執行異步操作（后臺線程）的同時，并且還能妥妥的顯示操作進度的解決方案。于是乎，我便深入的了解了一下BackgroundWorker類。針對BackgroundWorker類的部分重要屬性和方法進行了一次總結。?

1、屬性：

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。 用法：

//在DoWork中鍵入如下代碼
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();

2、方法：

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異常。?

用法：

for (int i = 0; i <= 100; i++)
{
    //向ProgressChanged報告進度
    bgWorker.ReportProgress(i,"Working");
    System.Threading.Thread.Sleep(10);
}

CancelAsync()?

請求取消當前正在執行的異步操作。調用該方法將使BackgroundWorker.CancellationPending屬性設置為True。?

但需要注意的是，并非每次調用CancelAsync()都能確保異步操作，CancelAsync()通常不適用于取消一個緊密執行的操作，更適用于在循環體中執行。?

用法：

//在需要執行取消操作的地方鍵入以下代碼
bgWorker.CancelAsync();

3、事件：

DoWork

用于承載異步操作。當調用BackgroundWorker.RunWorkerAsync()時觸發。?

需要注意的是，由于DoWork事件內部的代碼運行在非UI線程之上，所以在DoWork事件內部應避免于用戶界面交互，而于用戶界面交互的操作應放置在ProgressChanged和RunWorkerCompleted事件中。

ProgressChanged

當調用BackgroundWorker.ReportProgress(int percentProgress)方式時觸發該事件。?

該事件的ProgressChangedEventArgs.ProgressPercentage屬性可以接收來自ReportProgress方法傳遞的percentProgress參數值,ProgressChangedEventArgs.UserState屬性可以接收來自ReportProgress方法傳遞的userState參數。

RunWorkerCompleted

異步操作完成或取消時執行的操作，當調用DoWork事件執行完成時觸發。?

該事件的RunWorkerCompletedEventArgs參數包含三個常用的屬性Error,Cancelled,Result。其中，Error表示在執行異步操作期間發生的錯誤；Cancelled用于判斷用戶是否取消了異步操作；Result屬性接收來自DoWork事件的DoWorkEventArgs參數的Result屬性值，可用于傳遞異步操作的執行結果。

4、附源代碼：

前臺

后臺

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

運行結果：

原文鏈接：https://www.cnblogs.com/zhaoshujie/p/9634136.html

欄目分類
最近更新