麻豆安全网址入口,亚洲香蕉综合在人在线视看,日韩欧美同性一区二区三区

這是我在CodeProject上的第一篇文章。我希望對你有用

當(dāng)我開發(fā)軟件的時候。我通常因?yàn)橐粋€很耗時是任務(wù)需要完成。而請求讓用戶等待，并且通過也允許用戶取消。不論我做何種操作（比如下載文件。保存大文件等等）。我都需要做下面幾件事：

通過一個模態(tài)對話框來讓用戶等待操作完成

能讓用戶看到進(jìn)度。

能讓用戶隨時取消。

我搜了好久也沒找到拿來就能用的窗體控件，也許是我沒找到。于是我自己寫。。
圖1

背景

BackgroundWorker 類包含了我需要完成任務(wù)的所有東西。我只需要給他提供一個對話框。

使用代碼

ProgressForm 包含了一個BackgroundWorker ，你要做的僅僅就是提供了一個完成工作的方法。

ProgressForm form = new ProgressForm();
form.DoWork += new ProgressForm.DoWorkEventHandler(form_DoWork);
//如果想為后臺任務(wù)提供參數(shù)的話
form.Argument = something;

為了開始BackgroundWorker，只需要調(diào)用ShowDialog 方法。返回值則取決于任務(wù)是怎么完成的。

DialogResult result = form.ShowDialog();
if (result == DialogResult.Cancel)
{
//用戶點(diǎn)擊了取消
}
else if (result == DialogResult.Abort)
{
/未處理的異常拋出
//你可以得到異常信息
MessageBox.Show(form.Result.Error.Message);
}
else if (result == DialogResult.OK)
{
//正常完成
//結(jié)果存儲在 form.Result里
}

最后。任務(wù)方法看起來是這樣的。

void form_DoWork(ProgressForm sender, DoWorkEventArgs e)
{
//得到參數(shù)
object myArgument = e.Argument;

//做一些耗時的任務(wù)...
for (int i = 0; i < 100; i++)
{
//通知進(jìn)度
sender.SetProgress(i, "Step " + i.ToString() + " / 100...");

//...

//檢查是否點(diǎn)擊了取消
if (sender.CancellationPending)
{
e.Cancel = true;
return;
}
}
}

如果你想要改改進(jìn)度條，或者進(jìn)度條顯示的文本。SetProgress 有一些重載的方法

public void SetProgress(string status);
public void SetProgress(int percent);
public void SetProgress(int percent, string status);

最后一個可自定義的字符串是：有兩個預(yù)定義的字符串CancellingText 和DefaultStatusText. CancellingText ，這兩個字符串，當(dāng)用戶點(diǎn)擊取消的時候顯示

如何實(shí)現(xiàn)
ProgressForm 緊緊嵌入了一個BackgroundWorker ，并包裝進(jìn)了主函數(shù)。

首先。我設(shè)計了如圖所示的一個窗體，然后。添加了BackgroundWorker。

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

worker = new BackgroundWorker();
worker.WorkerReportsProgress = true;
worker.WorkerSupportsCancellation = true;
worker.DoWork += new System.ComponentModel.DoWorkEventHandler(worker_DoWork);
worker.ProgressChanged += new ProgressChangedEventHandler(
worker_ProgressChanged);
worker.RunWorkerCompleted += new RunWorkerCompletedEventHandler(
worker_RunWorkerCompleted);
}
void worker_DoWork(object sender, DoWorkEventArgs e)
{
}
void worker_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
}
void worker_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{
}
BackgroundWorker worker;
}

我們必須把DoWork事件暴露給用戶。我添加了一個委托。這樣。我可以很容易的訪問窗體成員

public delegate void DoWorkEventHandler(ProgressForm sender, DoWorkEventArgs e);
public event DoWorkEventHandler DoWork;

void worker_DoWork(object sender, DoWorkEventArgs e)
{
//后臺任務(wù)開始
//調(diào)用用戶的事件處理程序
if (DoWork != null)
DoWork(this, e);
}

好。我們已經(jīng)有了任務(wù)和事件。先愛。我們希望當(dāng)窗體顯示的時候。后臺任務(wù)盡可能開始。我們在Load事件中寫代碼

void ProgressForm_Load(object sender, EventArgs e)
{
worker.RunWorkerAsync();
}
現(xiàn)在寫一個方法通知進(jìn)度。添加代碼到ProgressChanged 事件處理程序中

public void SetProgress(int percent, string status)
{
worker.ReportProgress(percent, status);
}
void worker_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
if (e.ProgressPercentage >= progressBar.Minimum &&
e.ProgressPercentage <= progressBar.Maximum)
{
progressBar.Value = e.ProgressPercentage;
}
if (e.UserState != null)
labelStatus.Text = e.UserState.ToString();
}

我們快做好了�，F(xiàn)在我們添加取消按鈕

void buttonCancel_Click(object sender, EventArgs e)
{
//通過worker我們要取消
worker.CancelAsync();
//使取消按鈕不可用，改變狀態(tài)文本
buttonCancel.Enabled = false;
labelStatus.Text = "Cancelling..."
}
最后一件事是我們想要當(dāng)worker完成的時候自動關(guān)閉窗體，因?yàn)槲覀兊膚orker通過ShowDialog 方法啟動。如果直接接收返回結(jié)果會很好

void worker_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{
//ShowDialog返回值會指示worker是不是正確完成了
if (e.Error != null)
DialogResult = DialogResult.Abort;
else if (e.Cancelled)
DialogResult = DialogResult.Cancel;
else
DialogResult = DialogResult.OK;
//關(guān)閉窗體
Close();
}

主要的工作就完成了。我添加了一些預(yù)定義的字符串啊。如果正在取消。保護(hù)狀態(tài)不會改變。還有傳遞參數(shù)啊。
完整的代碼如下：

/// <summary>
/// 簡單的進(jìn)度窗體
/// </summary>
public partial class ProgressForm : Form
{
/// <summary>
/// 獲得進(jìn)度條以對他自定義
/// 在顯示窗體之前.
/// 不要在后臺任務(wù)中直接使用 !
/// </summary>
public ProgressBar ProgressBar { get { return progressBar; } }
/// <summary>
/// 傳遞給后臺任務(wù)的參數(shù).
/// </summary>
public object Argument { get; set; }
/// <summary>
/// 后臺任務(wù)的結(jié)果.
///也可以檢查ShowDialog返回值
///來看看是不是正確完成了.
/// </summary>

public RunWorkerCompletedEventArgs Result { get; private set; }
/// <summary>
/// 如果點(diǎn)擊了取消按鈕則為true
///后臺任務(wù)還在執(zhí)行
/// </summary>
public bool CancellationPending
{
get { return worker.CancellationPending; }
}

/// <summary>
/// 取消按鈕被點(diǎn)擊之后的顯示文本
/// </summary>
public string CancellingText { get; set; }
/// <summary>
/// 缺省狀態(tài)文本.
/// </summary>
public string DefaultStatusText { get; set; }
/// <summary>
/// DoWork事件的委托.
/// </summary>
/// <param name="sender">T事件源.</param>
/// <param name="e">包含事件數(shù)據(jù).</param>
public delegate void DoWorkEventHandler(ProgressForm sender, DoWorkEventArgs e);
/// <summary>
/// 當(dāng)后臺任務(wù)開始的時候發(fā)生.
/// </summary>
public event DoWorkEventHandler DoWork;

/// <summary>
/// 構(gòu)造函數(shù).
/// </summary>
public ProgressForm()
{
InitializeComponent();

DefaultStatusText = "Please wait...";
CancellingText = "Cancelling operation...";

worker = new BackgroundWorker();
worker.WorkerReportsProgress = true;
worker.WorkerSupportsCancellation = true;
worker.DoWork += new System.ComponentModel.DoWorkEventHandler(worker_DoWork);
worker.ProgressChanged += new ProgressChangedEventHandler(worker_ProgressChanged);
worker.RunWorkerCompleted += new RunWorkerCompletedEventHandler(
worker_RunWorkerCompleted);
}

/// <summary>
/// 改變狀態(tài)文本.
/// </summary>
/// <param name="status">新狀態(tài)文本.</param>
public void SetProgress(string status)
{
//如果沒有改變
//或者取消請求還在處理就不改變狀態(tài)文本
if (status != lastStatus && !worker.CancellationPending)
{
lastStatus = status;
worker.ReportProgress(progressBar.Minimum - 1, status);
}
}
/// <summary>
///改變進(jìn)度條的值
/// </summary>
/// <param name="percent">新值.</param>
public void SetProgress(int percent)
{
//如果值沒有改變就不要更新進(jìn)度條
if (percent != lastPercent)
{
lastPercent = percent;
worker.ReportProgress(percent);
}
}
/// <summary>
///改變進(jìn)度條值和文本.
/// </summary>
/// <param name="percent">N新值.</param>
/// <param name="status">新文本.</param>
public void SetProgress(int percent, string status)
{
//如果至少一個改變就調(diào)用
if (percent != lastPercent || (status != lastStatus && !worker.CancellationPending))
{
lastPercent = percent;
lastStatus = status;
worker.ReportProgress(percent, status);
}
}

private void ProgressForm_Load(object sender, EventArgs e)
{
//重用窗體，恢復(fù)缺省值
Result = null;
buttonCancel.Enabled = true;
progressBar.Value = progressBar.Minimum;
labelStatus.Text = DefaultStatusText;
lastStatus = DefaultStatusText;
lastPercent = progressBar.Minimum;
//窗體已載入就開始后臺任務(wù)
worker.RunWorkerAsync(Argument);
}

private void buttonCancel_Click(object sender, EventArgs e)
{
//通知后臺任務(wù)，我們要取消
worker.CancelAsync();
//取消按鈕不可用，改變文本
buttonCancel.Enabled = false;
labelStatus.Text = CancellingText;
}

void worker_DoWork(object sender, DoWorkEventArgs e)
{
//后臺任務(wù)開始
//調(diào)用用戶的處理程序
if (DoWork != null)
DoWork(this, e);
}

void worker_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
//確保新值可用并更新
if (e.ProgressPercentage >= progressBar.Minimum &&
e.ProgressPercentage <= progressBar.Maximum)
{
progressBar.Value = e.ProgressPercentage;
}
//如果取消請求正在處理就不要更新
if (e.UserState != null && !worker.CancellationPending)
labelStatus.Text = e.UserState.ToString();
}

void worker_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{
//后臺任務(wù)完成
//保持結(jié)果，關(guān)閉窗體
Result = e;
if (e.Error != null)
DialogResult = DialogResult.Abort;
else if (e.Cancelled)
DialogResult = DialogResult.Cancel;
else
DialogResult = DialogResult.OK;
Close();
}

BackgroundWorker worker;
int lastPercent;
string lastStatus;
}