在ASP.NET中支援斷點續傳下載大檔案(ZT)源碼_實用技巧

IE的內建下載功能中沒有斷點續傳功能，要實現斷點續傳功能，需要用到HTTP協議中鮮為人知的幾個回應標頭和要求標頭。

一. 兩個必要回應標頭Accept-Ranges、ETag
用戶端每次提交下載請求時，服務端都要添加這兩個回應標頭，以保證用戶端和服務端將此下載識別為可以斷點續傳的下載：
Accept-Ranges：告知下載用戶端這是一個可以恢複續傳的下載，存放本次下載的開始位元組位置、檔案的位元組大小；
ETag：儲存檔案的唯一標識（我在用的檔案名稱+檔案最後修改時間，以便續傳請求時對檔案進行驗證）；
Last-Modified：可選回應標頭，存放服務端檔案的最後修改時間，用於驗證

二. 一個重要要求標頭Range
Range：首次下載時，Range頭為null，此時服務端的回應標頭中必須添加回應標頭Accept-Ranges、ETag；
續傳請求時，其值表示用戶端已經收到的位元組數，即本次下載的開始位元組位置，服務端依據這個 值從相應位置讀取資料發送到用戶端。

三. 用於驗證的要求標頭If-Range、
當回應標頭中包含有Accept-Ranges、ETag時，續傳請求時，將包含這些要求標頭：
If-Range：對應回應標頭ETag的值；
Unless-Modified-Since：對應回應標頭Last-Modified的值。
續傳請求時，為了保證用戶端與服務端的檔案的一致性和正確性，有必要對檔案進行驗證，驗證需要自己寫驗證代碼，就根據解析這兩個要求標頭的值，將用戶端已下載的部分與服務端的檔案進行對比，如果不吻合，則從頭開始下載，如果吻合，則斷點續傳。

四. 速度限制
程式中加入了速度限制，用於對用戶端進行許可權控制的流量限制。

五. 其它注意事項
如：檔案名稱亂碼的問題、檔案名稱中空格變加號、強制用戶端顯示下載對話方塊等，詳見源碼注釋：

/**//// <summary> /// 下載檔案，支援大檔案、續傳、速度限制。支援續傳的回應標頭Accept-Ranges、ETag，要求標頭Range 。 /// Accept-Ranges：回應標頭，向用戶端指明，此進程支援可恢複下載.實現背景智慧型傳送服務（BITS），值為：bytes； /// ETag：回應標頭，用於對用戶端的初始（200）響應，以及來自用戶端的恢複請求， /// 必須為每個檔案提供一個唯一的ETag值（可由檔案名稱和檔案最後被修改的日期組成），這使用戶端軟體能夠驗證它們已經下載的位元組塊是否仍然是最新的。 /// Range：續傳的起始位置，即已經下載到用戶端的位元組數，值如：bytes=1474560- 。 /// 另外：UrlEncode編碼後會把檔案名稱中的空格轉換中+（+轉換為%2b），但是瀏覽器是不能理解加號為空白格的，所以在瀏覽器下載得到的檔案，空格就變成了加號； /// 解決辦法：UrlEncode 之後, 將 "+" 替換成 "%20"，因為瀏覽器將%20轉換為空白格 /// </summary> /// <param name="httpContext">當前請求的HttpContext</param> /// <param name="filePath">下載檔案的實體路徑，含路徑、檔案名稱</param> /// <param name="speed">下載速度：每秒允許下載的位元組數</param> /// <returns>true下載成功，false下載失敗</returns> public static bool DownloadFile(HttpContext httpContext, string filePath, long speed) { bool ret = true; try { #region--驗證：HttpMethod，請求的檔案是否存在 switch (httpContext.Request.HttpMethod.ToUpper()) { //目前只支援GET和HEAD方法 case "GET": case "HEAD": break; default: httpContext.Response.StatusCode = 501; return false; } if (!File.Exists(filePath)) { httpContext.Response.StatusCode = 404; return false; } #endregion #region 定義局部變數 long startBytes = 0; int packSize = 1024 * 10; //分塊讀取，每塊10K bytes string fileName = Path.GetFileName(filePath); FileStream myFile = new FileStream(filePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite); BinaryReader br = new BinaryReader(myFile); long fileLength = myFile.Length; int sleep = (int)Math.Ceiling(1000.0 * packSize / speed);//毫秒數：讀取下一資料區塊的時間間隔 string lastUpdateTiemStr = File.GetLastWriteTimeUtc(filePath).ToString("r"); string eTag = HttpUtility.UrlEncode(fileName, Encoding.UTF8) + lastUpdateTiemStr;//便於恢複下載時提取要求標頭; #endregion #region--驗證：檔案是否太大，是否是續傳，且在上次被請求的日期之後是否被修 if (myFile.Length > Int32.MaxValue) {//-------檔案太大了------- httpContext.Response.StatusCode = 413;//請求實體太大 return false; } if (httpContext.Request.Headers["If-Range"] != null)//對應回應標頭ETag：檔案名稱+檔案最後修改時間 { //----------上次被請求的日期之後被修改過-------------- if (httpContext.Request.Headers["If-Range"].Replace("\"", "") != eTag) {//檔案修改過 httpContext.Response.StatusCode = 412;//預先處理失敗 return false; } } #endregion try { #region -------添加重要回應標頭、解析要求標頭、相關驗證------------------- httpContext.Response.Clear(); httpContext.Response.Buffer = false; httpContext.Response.AddHeader("Content-MD5", GetMD5Hash(myFile));//用於驗證檔案 httpContext.Response.AddHeader("Accept-Ranges", "bytes");//重要：續傳必須 httpContext.Response.AppendHeader("ETag", "\"" + eTag + "\"");//重要：續傳必須 httpContext.Response.AppendHeader("Last-Modified", lastUpdateTiemStr);//把最後修改日期寫入響應 httpContext.Response.ContentType = "application/octet-stream";//MIME類型：匹配任意檔案類型 httpContext.Response.AddHeader("Content-Disposition", "attachment;filename=" + HttpUtility.UrlEncode(fileName, Encoding.UTF8).Replace("+", "%20")); httpContext.Response.AddHeader("Content-Length", (fileLength - startBytes).ToString()); httpContext.Response.AddHeader("Connection", "Keep-Alive"); httpContext.Response.ContentEncoding = Encoding.UTF8; if (httpContext.Request.Headers["Range"] != null) {//------如果是續傳請求，則擷取續傳的起始位置，即已經下載到用戶端的位元組數------ httpContext.Response.StatusCode = 206;//重要：續傳必須，表示局部範圍響應。初始下載時預設為200 string[] range = httpContext.Request.Headers["Range"].Split(new char[] { '=', '-' });//"bytes=1474560-" startBytes = Convert.ToInt64(range[1]);//已經下載的位元組數，即本次下載的開始位置 if (startBytes < 0 || startBytes >= fileLength) {//無效的起始位置 return false; } } if (startBytes > 0) {//------如果是續傳請求，告訴用戶端本次的開始位元組數，總長度，以便用戶端將續傳資料追加到startBytes位置後---------- httpContext.Response.AddHeader("Content-Range", string.Format(" bytes {0}-{1}/{2}", startBytes, fileLength - 1, fileLength)); } #endregion #region -------向用戶端發送資料區塊------------------- br.BaseStream.Seek(startBytes, SeekOrigin.Begin); int maxCount = (int)Math.Ceiling((fileLength - startBytes + 0.0) / packSize);//分塊下載，剩餘部分可分成的塊數 for (int i = 0; i < maxCount && httpContext.Response.IsClientConnected; i++) {//用戶端中斷串連，則暫停 httpContext.Response.BinaryWrite(br.ReadBytes(packSize)); httpContext.Response.Flush(); if (sleep > 1) Thread.Sleep(sleep); } #endregion } catch { ret = false; } finally { br.Close(); myFile.Close(); } } catch { ret = false; } return ret; }