DIV CSS 佈局教程網

Uploadify 多檔上傳帶進度條並傳遞自訂參數(含 ashx 後端)
編輯:JQuery特效代碼     

瀏覽器原生的檔案上傳無法客製進度、無法多選(在舊時代)、樣式也不能改。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>

二、後端一般用途處理常式(.ashx)

<%@ 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() 之前呼叫,上傳開始後才設定是來不及的。

這個年代的實作提醒

  • Flash 已於 2020 年底停止支援。 這套方案今日在現代瀏覽器上完全無法運作,僅具歷史與維護既有專案的參考價值。新專案請改用 <input type="file" multiple> 搭配 XMLHttpRequest 的 upload.onprogress,或直接使用 FormData 配合 fetch/axios 的 onUploadProgress。
  • 檔名不可信。 範例直接 file.FileName 存盤,這是嚴重的資安問題:可能包含 ../ 路徑跳脫,也可能覆蓋既有檔案。務必改為伺服器端產生 GUID 檔名,副檔名另外用白名單驗證。
  • 後端一定要再驗一次。 前端的 fileExt 與 sizeLimit 只是使用者體驗,任何限制都必須在伺服器端重做,並檢查實際的 MIME 與檔案內容(magic number),而不只是副檔名。
  • 要限制上傳目錄的執行權限。 上傳資料夾不應允許執行任何腳本,否則等於開放任意檔案上傳漏洞。
  • 以日期分資料夾(yyyyMMdd)是實用的做法,能避免單一目錄檔案過多,日後備份與清理也方便。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved