前言

軟件開發(fā)中，文件下載功能是許多應(yīng)用程序的常見需求。對于用戶而言，不僅希望下載過程穩(wěn)定高效，還希望能夠?qū)崟r掌握下載進度，從而提升用戶體驗。而使用 C# .NET 開發(fā)的 WinForm 應(yīng)用程序，我們可以通過簡單的代碼實現(xiàn)文件下載，并結(jié)合進度條（ProgressBar）和標簽（Label）來動態(tài)顯示下載狀態(tài)。

本文將以一段實際實現(xiàn)的代碼為基礎(chǔ)，詳細講解如何在 WinForm 中實現(xiàn)文件下載及進度條展示功能。

正文

整體邏輯

該代碼段的核心函數(shù)是 DownloadFile() 方法，它實現(xiàn)了從指定 URL 下載文件到本地路徑的功能，并通過進度條和標簽控件實時更新下載進度。

主要流程如下：

1、創(chuàng)建 HTTP 請求獲取遠程文件；

2、獲取文件總大小以設(shè)置進度條最大值；

3、創(chuàng)建本地文件流用于寫入數(shù)據(jù)；

4、使用循環(huán)讀取網(wǎng)絡(luò)流中的數(shù)據(jù)塊，并寫入本地文件；

5、實時計算并更新下載百分比與進度條；

6、異常處理以確保程序穩(wěn)定性。

代碼結(jié)構(gòu)

1、界面部分

界面由一個按鈕 btnDown_Click 觸發(fā)下載事件。

當(dāng)點擊按鈕后，會調(diào)用 DownloadFile() 方法，傳入下載地址、保存路徑、進度條控件和標簽控件作為參數(shù)。

private void btnDown_Click(object sender, EventArgs e)
{
    DownloadFile("http://localhost:1928/WebServer/downloader/123.rar", @"C:\123.rar", progressBar1, label1);
}

注意：上傳路徑為 "C:\123.rar"，注意路徑是否正確以及是否有寫權(quán)限。

2、下載方法

public void DownloadFile(string URL, string filename, System.Windows.Forms.ProgressBar prog, System.Windows.Forms.Label label1)
{
    float percent = 0;
    try
    {
        // 創(chuàng)建HTTP請求對象
        System.Net.HttpWebRequest Myrq = (System.Net.HttpWebRequest)System.Net.HttpWebRequest.Create(URL);
        System.Net.HttpWebResponse myrp = (System.Net.HttpWebResponse)Myrq.GetResponse();

        // 獲取文件總大小
        long totalBytes = myrp.ContentLength;

        // 設(shè)置進度條最大值
        if (prog != null)
        {
            prog.Maximum = (int)totalBytes;
        }

        // 獲取響應(yīng)流和創(chuàng)建文件流
        System.IO.Stream st = myrp.GetResponseStream();
        System.IO.Stream so = new System.IO.FileStream(filename, System.IO.FileMode.Create);

        long totalDownloadedByte = 0;
        byte[] by = newbyte[1024];
        int osize = st.Read(by, 0, (int)by.Length);

        // 循環(huán)讀取并寫入文件
        while (osize > 0)
        {
            totalDownloadedByte += osize;
            so.Write(by, 0, osize);

            // 更新進度條和標簽
            if (prog != null)
            {
                prog.Value = (int)totalDownloadedByte;
            }

            percent = (float)totalDownloadedByte / (float)totalBytes * 100;
            label1.Text = "當(dāng)前補丁下載進度：" + percent.ToString("#0.00") + "%";

            // 刷新UI
            System.Windows.Forms.Application.DoEvents();

            // 繼續(xù)讀取下一塊數(shù)據(jù)
            osize = st.Read(by, 0, (int)by.Length);
        }

        // 關(guān)閉流
        so.Close();
        st.Close();
    }
    catch (Exception ex)
    {
        MessageBox.Show("下載過程中發(fā)生錯誤：" + ex.Message);
    }
}

關(guān)鍵技術(shù)

1、多線程問題與 UI 阻塞

由于是直接在主線程中進行網(wǎng)絡(luò)下載操作，若不及時刷新界面，會導(dǎo)致 UI 卡頓甚至“無響應(yīng)”。因此，代碼中使用了：

System.Windows.Forms.Application.DoEvents();

此方法允許在下載循環(huán)過程中接收和處理 Windows 消息，從而保持界面響應(yīng)。

?? 注意：雖然 DoEvents() 可以暫時解決問題，但在大型項目或復(fù)雜場景中更推薦使用后臺線程（如 BackgroundWorker 或 async/await 異步編程模型）來避免阻塞主線程。

2、下載速度與緩沖區(qū)大小

本例中使用的緩沖區(qū)大小為 1KB（1024 字節(jié)），這個數(shù)值可以根據(jù)實際情況調(diào)整。

較大的緩沖區(qū)可以提高吞吐量，但也會增加內(nèi)存占用。

例如改為 8KB：

byte[] by = new byte[8192]; // 更改緩沖區(qū)大小

3、進度計算與格式化顯示

通過比較已下載字節(jié)數(shù)與總字節(jié)數(shù)，計算出百分比：

percent = (float)totalDownloadedByte / (float)totalBytes * 100;
label1.Text = "當(dāng)前補丁下載進度：" + percent.ToString("#0.00") + "%";

其中使用了格式字符串 #0.00 來保留兩位小數(shù)，使顯示更美觀。

總結(jié)

本文通過完整的WinForm代碼實現(xiàn)文件下載，深入講解了如何實現(xiàn)下載功能并配合控件實時顯示進度。整個過程簡潔有效，適用于小型工具類應(yīng)用。