一個簡單多線程等待窗口

在Winform程序開發中，經常會遇到長時間任務處理的時候需要顯示等待窗口和進度條的情況，如果直接在主窗口UI線程上執行，則窗口會假死和空白，用戶體驗很不友好。所以相信大家在實踐中都會經常實現自己的等待窗口和進度信息顯示，這也是一個我經常在項目開發中使用的小工具，方便地引入新項目中使用，特此與大家分享，並希望大家提出建議，一起交流多線程開發中的經驗。

既然要在處理任務的時候要保持主窗口和等待窗口的“活動”狀態，自然就想到了多線程和異步操作。.NET Framework里已經自帶了后台工作線程對象BackgroundWorker和進度條控件，所以實現起來並不難。這個自定義的等待窗口的好處就是已經把常用的顯示控件和接口實現好了，同時可以根據需要靈活修改和進一步美化，便於移植到不同項目中。

實現思路就是定義一個窗體，用來顯示進度和其它信息，供主窗口來調用。既然等待窗口只是用來顯示，所以它在調用的時候用Form.Show()方法，同時將它定義為單例對象，便於不同的代碼段來共同操作它。

主要代碼摘錄如下：

1.等待窗口的主要定義

/// <summary>
        /// 返回單個實例對象
        /// </summary>
        /// <returns></returns>
        public static WaitWindow GetInstance()
        {
            if( instance == null || instance.IsDisposed)
            {
                instance = new WaitWindow();
            }
            else
            {
                instance.label_percent.Text = "";
            }
            return instance;
        }

        /// <summary>
        ///請求終止當前系統正在處理的事務
        /// </summary>        
        public event System.EventHandler OnProcessAbort;

        /// <summary>
        /// 修改進度條窗口標題
        /// </summary>
        /// <returns></returns>
        public string Caption
        {
            set { this.Text = value; }
        }
        /// <summary>
        /// 修改提示信息
        /// </summary>
        /// <returns></returns>
        public string Title
        {
            set { this.label_prompt.Text = value; }
        }
        /// <summary>
        /// 修改進度信息
        /// </summary>
        public string ProgressInfo
        {
            set { this.label_percent.Text = value; }
        }

        /// <summary>
        /// 是否開啟取消按鈕的可用狀態（默認開啟）
        /// </summary>
        public bool IsCancelEnable
        {
            set { this.btn_cancel.Enabled = value; }
        }

        /// <summary>
        /// 設置/讀到是否顯示進度條（默認關閉，如開啟，則要傳遞Value以刷新進度條）
        /// </summary>
        public bool IsProgressBarVisible
        {
            set { this.progressBar.Visible = value; }
            get { return this.progressBar.Visible; }
        }
        /// <summary>
        /// 設置/讀取當前進度條value
        /// </summary>
        public int ProgressValue
        {
            set { this.progressBar.Value = value; }
            get { return this.progressBar.Value; }
        }
        /// <summary>
        /// 設置/讀取進度條的最大值（默認100）
        /// </summary>
        public int ProgressMaxValue
        {
            set { this.progressBar.Maximum = value; }
            get { return this.progressBar.Maximum; }
        }

 

2.主窗口的調用和實現

//用戶是否取消當前任務
        private bool isUserCancel = false;

        private void btnDoWork_Click(object sender, EventArgs e)
        {
            isUserCancel = false;
            //顯示進度窗口
            WaitWindow waitx = WaitWindow.GetInstance();
            waitx.IsProgressBarVisible = true;  //開啟進度條
            waitx.ProgressMaxValue = 10;       //進度條最大value(結束值)
            waitx.OnProcessAbort += new EventHandler(waitx_OnProcessAbort); //用戶取消事件
            waitx.Show();
            //使用另一線程進行任務處理
            Thread t = new Thread(new ThreadStart(this.DoLongTimeTask));
            t.Start();
        }

        void waitx_OnProcessAbort(object sender, EventArgs e)
        {
            isUserCancel = true;
        }
        //通知進度代理
        delegate void NotifyProgressHandler(int progressValue);

        //進度通知處理方法
        void NotifyProgress(int v)
        {
            WaitWindow win = WaitWindow.GetInstance();
            win.ProgressValue = v;  //當前進度
            string msg = "已完成: " + v + "/" + win.ProgressMaxValue;
            win.ProgressInfo = msg;
        }

        //執行長時間任務處理
        void DoLongTimeTask()
        {
            int i = 1;
            //因為有可能用戶會取消，要隨時判斷取消標記
            while (i < 11 && !isUserCancel)
            {
                Thread.Sleep(1000);     //耗時工作
                Console.WriteLine("current value:" + i);
                //通知等待窗口當前進度(BeginInvoke)
                this.BeginInvoke(new NotifyProgressHandler(this.NotifyProgress), i);
                i++;
            }
            //任務處理完畢
            if (this.InvokeRequired)
                this.Invoke(new MethodInvoker(this.EndTask));
            else
                this.EndTask();
        }

        //任務處理結束（需要關閉等待窗口以及告知處理結果等）
        void EndTask()
        {
            WaitWindow win = WaitWindow.GetInstance();
            win.Close();
            if (isUserCancel)
                MessageBox.Show("任務處理已被用戶取消，即將退出.  ", "任務處理", MessageBoxButtons.OK, MessageBoxIcon.Asterisk);
            else
                MessageBox.Show("任務處理已經完成.", "任務處理", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }

 

運行效果如下圖：

 

 

代碼下載：WaitWindowApp

歡迎進一步交流：）