瀏覽器原生的檔案上傳無法客製進度、無法多選(在舊時代)、樣式也不能改。Uploadify 是 Flash 時代的解法,用一個小 SWF 接手傳輸,前端就能拿到完整的進度控制與自訂參數能力。以下是一份可運作的完整實作。
<%@ Page Language="C#" AutoEventWireup="true"
CodeFile="UpLoad.aspx.cs" Inherits="UploadifyDemo_UpLoad" %>
<html xmlns="https://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>jQuery Uploadify 上傳帶進度條,且多參數</title>
<link href="js/jquery.uploadify-v2.1.4/uploadify.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="js/jquery.uploadify-v2.1.4/jquery-1.4.2.min.js"></script>
<script type="text/javascript" src="js/jquery.uploadify-v2.1.4/swfobject.js"></script>
<script type="text/javascript" src="js/jquery.uploadify-v2.1.4/jquery.uploadify.v2.1.4.min.js"></script>
<script type="text/javascript">
$(document).ready(function () {
$("#uploadify").uploadify({
'uploader': 'js/jquery.uploadify-v2.1.4/uploadify.swf', // SWF 路徑
'script': 'UploadHandler.ashx', // 後端處理腳本
'cancelImg': 'js/jquery.uploadify-v2.1.4/cancel.png',
'folder': 'UploadFile/<% = DateTime.Now.ToString("yyyyMMdd") %>', // 以日期分資料夾
'queueID': 'fileQueue', // 作為檔案佇列顯示區的元素 id
'auto': false, // 加入佇列後不自動上傳
'multi': true, // 允許多檔
'fileExt': '*.jpg;*.gif;*.png', // 允許的副檔名
'fileDesc': 'Web Image Files (.JPG, .GIF, .PNG)', // 檔案選擇視窗的說明文字
'sizeLimit': 102400, // 單檔大小上限(位元組),此處 100KB
'onAllComplete': function (event, data) { // 全部上傳完成
alert(data.filesUploaded + ' 個檔案上傳成功!');
}
});
});
function uploadpara() {
// 傳遞自訂參數
$('#uploadify').uploadifySettings('scriptData', {
'name': $('#txtName').val(),
'albums': $('#txtAlbums').val()
});
$('#uploadify').uploadifyUpload();
}
</script>
</head>
<body>
<form id="form1" runat="server">
<div>
用戶名:<asp:TextBox ID="txtName" runat="server"></asp:TextBox><br/>
相冊名:<asp:TextBox ID="txtAlbums" runat="server"></asp:TextBox>
</div>
</form>
<div id="fileQueue"></div>
<input type="file" name="uploadify" id="uploadify" />
<p>
<a href="javascript:void(0);" onclick="uploadpara();">上傳</a>|
<a href="javascript:$('#uploadify').uploadifyClearQueue()">取消上傳</a>
</p>
</body>
</html>
<%@ WebHandler Language="C#" Class="UploadHandler" %>
using System;
using System.Web;
using System.IO;
/// <summary>
/// UploadHandler 檔案上傳
/// </summary>
public class UploadHandler : IHttpHandler
{
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"]);
string name = context.Request.Params["name"]; // 取得傳遞的參數
string albums = context.Request.Params["albums"];
if (file != null)
{
if (!Directory.Exists(uploadPath))
{
Directory.CreateDirectory(uploadPath);
}
file.SaveAs(Path.Combine(uploadPath, file.FileName));
context.Response.Write("1");
}
else
{
context.Response.Write("0");
}
}
public bool IsReusable
{
get { return false; }
}
}
關鍵在 uploadifySettings('scriptData', {...})。Uploadify 透過 Flash 送出請求時,這些鍵值會被附加到表單資料中,後端就能用 context.Request.Params["name"] 取得。注意這必須在 uploadifyUpload() 之前呼叫,上傳開始後才設定是來不及的。
<input type="file" multiple> 搭配 XMLHttpRequest 的 upload.onprogress,或直接使用 FormData 配合 fetch/axios 的 onUploadProgress。file.FileName 存盤,這是嚴重的資安問題:可能包含 ../ 路徑跳脫,也可能覆蓋既有檔案。務必改為伺服器端產生 GUID 檔名,副檔名另外用白名單驗證。fileExt 與 sizeLimit 只是使用者體驗,任何限制都必須在伺服器端重做,並檢查實際的 MIME 與檔案內容(magic number),而不只是副檔名。yyyyMMdd)是實用的做法,能避免單一目錄檔案過多,日後備份與清理也方便。