如果直接用伺服器端的上傳控制項,按下上傳鈕會導致整頁刷新一次,對使用者體驗不太好。ajaxfileupload.js 是一款 jQuery 的非同步上傳外掛,使用方式簡單,效果流暢。
下載 ajaxfileupload.js 並與 jQuery 一起引入(順序不能顛倒,外掛一定要在 jQuery 之後):
<script src="/Content/JQueryJS/jquery-2.1.1.js"></script>
<script src="/Content/Js/ajaxfileupload.js"></script>
<input id="fileToUpload" type="file" name="fileToUpload">
function saveCInfo() {
var filename = document.getElementById("fileToUpload").value;
if (filename != "") {
$.ajaxFileUpload({
url: '../Order/OrderExec.ashx?oprMode=fileUpload' +
"&filename=" + filename +
"&billno=" + billno +
"&companyname=" + companyname,
secureuri: false,
fileElementId: 'fileToUpload', // 上傳控件的 ID
error: function () {
alert('error');
},
success: function (datax) {
if (datax != "") {
msgShow('系統提示', '上傳成功!', 'info');
} else {
msgShow('系統提示', '上傳失敗!', 'info');
}
}
});
} else {
$.messager.alert('提示', '請選擇上傳檔案', 'info');
}
}
public void FileUpload(HttpContext context)
{
try
{
context.Response.ContentType = "text/html";
string companyname = context.Request.Params["companyname"];
string billno = context.Request.Params["billno"];
string filename = context.Request.Params["filename"];
string name = companyname + "_" + billno + "_" + filename;
HttpFileCollection files = HttpContext.Current.Request.Files;
// 指定伺服器上的保存路徑
string savePath = context.Server.MapPath("~/upload/");
// 檢查目錄是否存在,不存在則建立
if (!System.IO.Directory.Exists(savePath))
{
System.IO.Directory.CreateDirectory(savePath);
}
savePath = savePath + name;
files[0].SaveAs(savePath);
context.Response.Write(savePath);
}
catch (Exception ex)
{
context.Response.Write("FileUpload: " + ex.Message);
}
}
檔名安全。上面把 filename 直接從查詢字串取出後拼接成儲存路徑,這有 path traversal 風險——對方只要傳 ..\..\web.config 就能寫到上傳目錄之外。正確做法是用伺服器端 files[0].FileName 並經過 Path.GetFileName() 清除路徑,再自行產生儲存名稱(例如 GUID + 副檔名),不要把使用者傳入的字串當路徑使用。
副檔名白名單。若不限制類型,任何人都能上傳 .aspx 或 .ashx 並在該目錄執行,等於直接給出遠端執行能力。必須以副檔名白名單(而非黑名單)驗證,並確認上傳目錄不允許執行腳本。
以 GET 傳檔名。把檔名放在 URL 查詢字串會曝光在伺服器日誌、 also 受長度限制,且中文檔名容易有編碼問題。建議在 ajaxFileUpload 中改用 data 傳 POST 參數。
值得理解的是:ajaxfileupload 並不是真的用 XHR 上傳。它的做法是動態建立一個隱藏的 <iframe>,讓表單 target 指向它,藉此避免整頁刷新;上傳完成後再從 iframe 讀取回應內容回傳給回呼。這也是為什麼它需要 secureuri 參數,以及為何回傳值永遠被當成字串處理。
現代專案請直接用 FormData 搭配 fetch 或 XMLHttpRequest,並掛上 upload.onprogress 就能取得真實進度:
var fd = new FormData();
fd.append("file", document.getElementById("fileToUpload").files[0]);
fetch("/api/upload", { method: "POST", body: fd })
.then(r => r.json())
.then(data => console.log(data));
不需要 iframe、不需要 Flash、不需要外掛。