C# 異步下載文件

在C#當(dāng)中，利用WebClient這個(gè)核心類，可以輕易的打造一個(gè)下載器。但是這里想要強(qiáng)調(diào)的是，我們用的是異步操作。所謂異步，是相對于同步的概念而言的。比如Web中的Ajax就是基于異步的。它能夠提供良好的用戶體驗(yàn)，讓用戶在進(jìn)行操作時(shí)，不感覺到“卡”（不阻塞UI線程），能夠同時(shí)進(jìn)行其它的操作并能夠隨意的切換到任務(wù)界面。在下載文件時(shí)，如果文件過大，我們用同步的下載方式進(jìn)行下載會感覺程序“假死”，其實(shí)程序在后臺不斷的運(yùn)行，但我們看不到下載的過程。所以這時(shí)候使用異步方法能夠有效的解決這個(gè)問題。

先看一下程序的界面：

實(shí)現(xiàn)上面的操作很簡單，只需要幾行代碼就可以搞定。

private void button1_Click(object sender, EventArgs e)
{
    using (WebClient client = new WebClient())
    {
        client.DownloadFileAsync(new Uri(this.textBox1.Text.Trim()),Path.GetFileName(this.textBox1.Text.Trim()));
        client.DownloadProgressChanged += client_DownloadProgressChanged;
        client.DownloadFileCompleted += client_DownloadFileCompleted;
    }
}
                              
void client_DownloadProgressChanged(object sender, DownloadProgressChangedEventArgs e)
{
    this.label1.Text = string.Format("當(dāng)前接收到{0}字節(jié)，文件大小總共{1}字節(jié)", e.BytesReceived, e.TotalBytesToReceive);
    this.progressBar1.Value = e.ProgressPercentage;
}
                              
void client_DownloadFileCompleted(object sender, System.ComponentModel.AsyncCompletedEventArgs e)
{
    if (e.Cancelled)
    {
        MessageBox.Show("文件下載被取消", "提示", MessageBoxButtons.OKCancel);
    }
    this.progressBar1.Value = 0;
    MessageBox.Show("文件下載成功", "提示");
}

我們只需要在textbox中填入文件的地址，比如迅雷的下載地址：http://dlsw.baidu.com/sw-search-sp/soft/ca/13442/Thunder_dl_7.9.18.4706Preview.2205245239.exe，就可以用上面的代碼進(jìn)行下載了。

在C#當(dāng)中，還可以利用HttpWebRequest進(jìn)行文件的異步下載。下面的代碼可能稍微有點(diǎn)復(fù)雜，但是可以幫助我們深入理解“異步“操作的過程。

我們先定義一個(gè)類，用于保存操作的狀態(tài)：

/// <summary>
/// 請求狀態(tài)
/// </summary>
public class RequestState
{
    /// <summary>
    /// 緩沖區(qū)大小
    /// </summary>
    public int BUFFER_SIZE { get; set; }
                          
    /// <summary>
    /// 緩沖區(qū)
    /// </summary>
    public byte[] BufferRead { get; set; }
                          
    /// <summary>
    /// 保存路徑
    /// </summary>
    public string SavePath { get; set; }
                          
    /// <summary>
    /// 請求流
    /// </summary>
    public HttpWebRequest Request { get; set; }
                          
    /// <summary>
    /// 響應(yīng)流
    /// </summary>
    public HttpWebResponse Response { get; set; }
                          
    /// <summary>
    /// 流對象
    /// </summary>
    public Stream ResponseStream { get; set; }
                          
    /// <summary>
    /// 文件流
    /// </summary>
    public FileStream FileStream { get; set; }
}

在一個(gè)Button的Click事件下，鍵入如下代碼：

//下載文件的url
string url = this.textBox1.Text.Trim();
                     
//創(chuàng)建一個(gè)初始化請求對象
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(new Uri(url));
                     
//設(shè)置下載相關(guān)參數(shù)
RequestState requestState = new RequestState();
requestState.BUFFER_SIZE = 1024;
requestState.BufferRead = new byte[requestState.BUFFER_SIZE];
requestState.Request = request;
requestState.SavePath = Path.Combine("D:\\", Path.GetFileName(url));
requestState.FileStream = new FileStream(requestState.SavePath, FileMode.OpenOrCreate);
                     
//開始異步請求資源
request.BeginGetResponse(new AsyncCallback(ResponseCallback), requestState);

我們可以看到，異步的操作方法一般都是以Begin開頭的BeginGetResponse，我們平時(shí)用的比較多的同步方法直接使用GetResponse。另外AsyncCallback是一個(gè)委托，前面講過，它里面的參數(shù)是一個(gè)方法，我們起名為ResponseCallback，并且把requestState作為參數(shù)傳遞過去。

接下來就可以看一下ResponseCallback方法：

/// <summary>
/// 請求資源方法的回調(diào)函數(shù)
/// </summary>
/// <param name="asyncResult">用于在回調(diào)函數(shù)當(dāng)中傳遞操作狀態(tài)</param>
private void ResponseCallback(IAsyncResult asyncResult)
{
    RequestState requestState = (RequestState)asyncResult.AsyncState;
    requestState.Response = (HttpWebResponse)requestState.Request.EndGetResponse(asyncResult);
               
    Stream responseStream = requestState.Response.GetResponseStream();
    requestState.ResponseStream = responseStream;
               
    //開始異步讀取流
    responseStream.BeginRead(requestState.BufferRead, 0, requestState.BufferRead.Length, ReadCallback, requestState);
}

我們可以看到，回調(diào)函數(shù)里面又有一個(gè)異步操作。它的任務(wù)是對響應(yīng)流異步的讀取到緩沖區(qū)當(dāng)中。

再進(jìn)一步，看一下ReadCallback回調(diào)函數(shù)。

/// <summary>
/// 異步讀取流的回調(diào)函數(shù)
/// </summary>
/// <param name="asyncResult">用于在回調(diào)函數(shù)當(dāng)中傳遞操作狀態(tài)</param>
private void ReadCallback(IAsyncResult asyncResult)
{
    RequestState requestState = (RequestState)asyncResult.AsyncState;
    int read = requestState.ResponseStream.EndRead(asyncResult);
    if (read > 0)
    {
        //將緩沖區(qū)的數(shù)據(jù)寫入該文件流
        requestState.FileStream.Write(requestState.BufferRead, 0, read);
         
        //開始異步讀取流
        requestState.ResponseStream.BeginRead(requestState.BufferRead, 0, requestState.BufferRead.Length, ReadCallback, requestState);
    }
    else
    {
        requestState.Response.Close();
        requestState.FileStream.Close();
    }
}

這里面是真正的將流寫入文件的過程，并且用BeginRead方法遞歸的寫入文件流直到文件完全寫好為止（完全下載到本地）。

上面我參考了官方網(wǎng)站上面的代碼，可以在這里查詢到：BeginGetResponse。這是一個(gè)經(jīng)典的異步操作的例子，希望大家能夠好好理解。