Uploadify 是 jQuery 的多檔上傳外掛,自帶進度條,效果相當完整。官網提供的是 PHP 版範例,本文記錄在 ASP.NET 下的完整使用方式。

<link href="JS/jquery.uploadify-v2.1.0/example/css/default.css" rel="stylesheet" type="text/css" />
<link href="JS/jquery.uploadify-v2.1.0/uploadify.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="JS/jquery.uploadify-v2.1.0/jquery-1.3.2.min.js"></script>
<script type="text/javascript" src="JS/jquery.uploadify-v2.1.0/swfobject.js"></script>
<script type="text/javascript"
src="JS/jquery.uploadify-v2.1.0/jquery.uploadify.v2.1.0.min.js"></script>
<script type="text/javascript">
$(document).ready(function() {
$("#uploadify").uploadify({
'uploader': 'JS/jquery.uploadify-v2.1.0/uploadify.swf',
'script': 'UploadHandler.ashx',
'cancelImg': 'JS/jquery.uploadify-v2.1.0/cancel.png',
'folder': 'UploadFile',
'queueID': 'fileQueue',
'auto': false,
'multi': true
});
});
</script>
<body>
<div id="fileQueue"></div>
<input type="file" name="uploadify" id="uploadify" />
<p>
<a href="javascript:$('#uploadify').uploadifyUpload()">上傳</a>|
<a href="javascript:$('#uploadify').uploadifyClearQueue()">取消上傳</a>
</p>
</body>
public void ProcessRequest(HttpContext context)
{
context.Response.ContentType = "text/plain";
context.Response.Charset = "utf-8";
HttpPostedFile file = context.Request.Files["Filedata"];
string uploadPath =
HttpContext.Current.Server.MapPath(context.Request["folder"]) + "\\";
if (file != null)
{
if (!Directory.Exists(uploadPath))
{
Directory.CreateDirectory(uploadPath);
}
file.SaveAs(uploadPath + file.FileName);
// 少了這行,上傳成功後佇列項目不會自動消失
context.Response.Write("1");
}
else
{
context.Response.Write("0");
}
}
這裡一定要 using System.IO;。我當初出錯就是漏了這個命名空間,而網上多數教學都沒特別提,導致不少人遇到 IOError。
執行後即可看到上傳介面:

選好兩個檔案按上傳,UploadFile 資料夾就會多出這兩個檔案。
uploadify 的參數是 JSON 物件,改 key 就能自訂行為,例如 multi 控制是否多檔上傳。

'*.doc;*.pdf;*.rar'。
以下 key 的值是函數,可在選檔、出錯等時刻回傳資訊給使用者。
初始化工作。
選擇檔案時觸發,三個參數:event(事件物件)、queueID(六碼隨機組成的唯一標識)、fileObj(檔案物件,含 name、size、creationDate、modificationDate、type 五個屬性)。
$(document).ready(function() {
$("#uploadify").uploadify({
'uploader': 'JS/jquery.uploadify-v2.1.0/uploadify.swf',
'script': 'UploadHandler.ashx',
'cancelImg': 'JS/jquery.uploadify-v2.1.0/cancel.png',
'folder': 'UploadFile',
'queueID': 'fileQueue',
'auto': false,
'multi': true,
'onInit': function(){ alert("1"); },
'onSelect': function(e, queueId, fileObj) {
alert("唯一標識:" + queueId + "\r\n" +
"文件名:" + fileObj.name + "\r\n" +
"文件大小:" + fileObj.size + "\r\n" +
"創建時間:" + fileObj.creationDate + "\r\n" +
"最後修改時間:" + fileObj.modificationDate + "\r\n" +
"文件類型:" + fileObj.type);
}
});
});

單檔或多檔上傳時,選檔觸發一次。參數 event 與 data,data 含:
點擊佇列項目的關閉鈕或取消上傳時觸發。參數 event、queueId、fileObj、data;data 含 fileCount(取消後佇列剩餘數量)與 allBytesTotal(剩餘檔案大小)。
呼叫 fileUploadClearQueue 時觸發,參數 event 與 data,含義同 onCancel 的對應參數。
設定了 queueSizeLimit 且選擇數量超出時觸發,參數 event 與 queueSizeLimit。
上傳出錯時觸發。參數 event、queueId、fileObj、errorObj。errorObj 有兩個屬性:type('HTTP'、'IO' 或 'Security')與 info(錯誤描述)。
點擊上傳時觸發(auto 為 true 則是選檔時),多檔時會遍歷整個佇列,onProgress 在 onOpen 之後。參數 event、queueId、fileObj、data;data 含 percentage(完成百分比)、bytesLoaded(當前上傳量)、allBytesLoaded(佇列中已完成的上傳量)、speed(速率 kb/s)。
單檔上傳完成後觸發。參數 event、queueId、fileObj、response、data。response 是後台回傳值(範例中為 1 或 0),data 含 fileCount(尚未完成的數量)與 speed(平均速率)。此處的 fileObj 多了 filePath 屬性,可取出上傳後的路徑。
整個佇列都完成後觸發。參數 event 與 data,data 含 filesUploaded(上傳檔案數)、errors(錯誤數)、allBytesLoaded(總大小)、speed(平均速率 kb/s)。
$('#uploadify').uploadifySettings('folder','JS');若把上傳連結寫成下面這樣,檔案就會传到 uploadifySettings 指定的目錄:
<a href="javascript:$('#uploadify').uploadifySettings('folder','JS');$('#uploadify').uploadifyUpload()">上傳</a>
$('#uploadify').uploadifyCancel(id);1. Flash 沒載入。剛設定好時完全不能動,uploadify.swf 就是載不進來。查了 jquery.uploadify.v2.1.0.js 才知道它是用 swfobject.js 動態建立 Flash 的。另外寫了一個獨立測試頁也一樣顯示不出來,最後重開電腦就正常了——這類狀況多半與瀏覽器快取或 Flash 外掛狀態有關。
2. Flash 出來了,上傳卻失敗,報 IOError。

翻遍網路,最後在國外某個網站看到一句 using System.IO;,加上去立刻豁然開朗。
補充一點:Uploadify 2.x 依賴 Flash,而主流瀏覽器已全面停止支援 Flash,因此這套方案今天只能用於維護既有專案。新專案建議改用 HTML5 方案,例如 jQuery File Upload 或直接用 <input type="file" multiple> 搭配 FormData 與 $.ajax,就能取得多檔上傳與進度回報(XMLHttpRequest.upload.onprogress),不必再受 Flash 的限制。