萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery Uploadify 文件上傳帶進度條完整實作指南 (ASP.NET 後端)

技術棧說明

  • 前端:jQuery + Uploadify v2.1.4 (Flash 基礎,已停止維護)
  • 後端:ASP.NET Web Forms (.ashx 處理器)
  • 注意:Uploadify v2 基於 Flash,現代瀏覽器已不支援。新專案請改用 HTML5 原生方案(如 Fine Uploader、Uppy、Dropzone.js 或原生 fetch + FormData)。本文僅供維護舊專案參考。

前端頁面

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Upload.aspx.cs" Inherits="Demo.Upload" %>
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
  <meta charset="utf-8" />
  <title>Uploadify 文件上傳示例</title>
  <link href="js/uploadify/uploadify.css" rel="stylesheet" />
  <script src="js/jquery-1.4.2.min.js"></script>
  <script src="js/uploadify/swfobject.js"></script>
  <script src="js/uploadify/jquery.uploadify.v2.1.4.min.js"></script>
  <style>
    #fileQueue { margin: 10px 0; }
    .uploadify-queue-item { border: 1px solid #ddd; padding: 8px; margin: 5px 0; background: #fafafa; }
    .uploadify-progress { height: 4px; background: #eee; overflow: hidden; }
    .uploadify-progress-bar { height: 100%; background: #3498db; width: 0%; transition: width 0.3s; }
  </style>
</head>
<body>
  <h2>多檔案上傳 (支援 JPG/PNG/GIF, 最大 100KB)</h2>
  
  <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>

  <script>
    $(function() {
      $('#uploadify').uploadify({
        'uploader': 'js/uploadify/uploadify.swf',
        'script': 'UploadHandler.ashx',
        'cancelImg': 'js/uploadify/cancel.png',
        'folder': 'UploadFiles/',
        'queueID': 'fileQueue',
        'auto': false,           // 手動觸發上傳
        'multi': true,           // 多檔案
        'fileExt': '*.jpg;*.jpeg;*.gif;*.png',
        'fileDesc': '圖片檔案',
        'sizeLimit': 102400,     // 100KB
        'buttonText': '選擇圖片',
        'width': 120,
        'height': 30,
        'onSelect': function(event, queueID, fileObj) {
          console.log('已選擇:', fileObj.name, '大小:', fileObj.size);
        },
        'onCancel': function(event, queueID, fileObj) {
          console.log('取消上傳:', fileObj.name);
        },
        'onComplete': function(event, queueID, fileObj, response, data) {
          console.log('單檔完成:', fileObj.name, '回應:', response);
        },
        'onAllComplete': function(event, data) {
          alert('上傳完成:' + data.filesUploaded + ' 個檔案,' + data.errors + ' 個錯誤');
        },
        'onError': function(event, queueID, fileObj, errorObj) {
          alert('錯誤:' + fileObj.name + ' - ' + errorObj.type + ': ' + errorObj.info);
        }
      });
    });
  </script>
</body>
</html>

後端處理器

<%@ WebHandler Language="C#" Class="UploadHandler" %>
using System;
using System.Web;
using System.IO;

public class UploadHandler : IHttpHandler {
  public void ProcessRequest(HttpContext context) {
    context.Response.ContentType = "text/plain";
    context.Response.Charset = "utf-8";
    
    try {
      HttpPostedFile file = context.Request.Files["Filedata"];
      if (file == null || file.ContentLength == 0) {
        context.Response.Write("0");
        return;
      }
      
      // 取得儲存路徑 (從前端傳來的 folder 參數)
      string folder = context.Request["folder"] ?? "UploadFiles/";
      string uploadPath = context.Server.MapPath("~/" + folder);
      
      // 建立目錄
      if (!Directory.Exists(uploadPath)) {
        Directory.CreateDirectory(uploadPath);
      }
      
      // 檔名處理:避免衝突、過濾危險字元
      string fileName = Path.GetFileName(file.FileName);
      fileName = SanitizeFileName(fileName);
      string savePath = Path.Combine(uploadPath, fileName);
      
      // 同名檔案處理:加上時間戳
      if (File.Exists(savePath)) {
        string ext = Path.GetExtension(fileName);
        string name = Path.GetFileNameWithoutExtension(fileName);
        fileName = name + "_" + DateTime.Now.ToString("yyyyMMddHHmmss") + ext;
        savePath = Path.Combine(uploadPath, fileName);
      }
      
      // 儲存
      file.SaveAs(savePath);
      
      // 回傳成功 (Uploadify 預期回傳 "1" 表示成功)
      context.Response.Write("1");
      
    } catch (Exception ex) {
      context.Response.Write("0");
      // 記錄錯誤日誌
      // Log.Error(ex);
    }
  }
  
  private string SanitizeFileName(string fileName) {
    // 移除路徑遍歷字元、特殊字元
    foreach (char c in Path.GetInvalidFileNameChars()) {
      fileName = fileName.Replace(c, '_');
    }
    return fileName;
  }
  
  public bool IsReusable { get { return false; } }
}

Uploadify 關鍵配置選項

選項類型說明
uploaderstringuploadify.swf 路徑 (Flash 檔案)
scriptstring後端處理器 URL (.ashx/.php/.jsp)
folderstring伺服器儲存相對路徑
queueIDstring顯示上傳隊列的容器 ID
autobooleantrue=選檔即上傳, false=手動觸發
multibooleantrue=允許多檔
fileExtstring允許副檔名,分號分隔
fileDescstring檔案選擇對話框顯示的說明
sizeLimitnumber單檔大小限制 (bytes)
buttonTextstring按鈕顯示文字
width/heightnumber按鈕尺寸

現代 HTML5 替代方案 (強烈建議)

Uploadify 基於 Flash,2020 年後瀏覽器全面封鎖 Flash。請遷移至以下方案:

方案一:原生 Fetch + FormData (零依賴)

async function uploadFiles(files) {
  const formData = new FormData();
  for (const file of files) {
    formData.append('files', file);
  }
  
  const response = await fetch('/api/upload', {
    method: 'POST',
    body: formData
  });
  
  return response.json();
}

// 進度顯示需使用 XMLHttpRequest
function uploadWithProgress(files, onProgress) {
  return new Promise((resolve, reject) => {
    const xhr = new XMLHttpRequest();
    const formData = new FormData();
    files.forEach(f => formData.append('files', f));
    
    xhr.upload.onprogress = e => {
      if (e.lengthComputable) onProgress(e.loaded / e.total);
    };
    xhr.onload = () => resolve(JSON.parse(xhr.responseText));
    xhr.onerror = () => reject(new Error('上傳失敗'));
    xhr.open('POST', '/api/upload');
    xhr.send(formData);
  });
}

方案二:Uppy.js (模組化、支援多來源)

import Uppy from '@uppy/core';
import Dashboard from '@uppy/dashboard';
import XHRUpload from '@uppy/xhr-upload';

const uppy = new Uppy()
  .use(Dashboard, { target: '#uppy', inline: true })
  .use(XHRUpload, { endpoint: '/api/upload' });

uppy.on('complete', (result) => {
  console.log('成功:', result.successful);
  console.log('失敗:', result.failed);
});

方案三:Dropzone.js (拖曳上傳經典選擇)

Dropzone.options.myDropzone = {
  url: '/api/upload',
  maxFilesize: 2, // MB
  acceptedFiles: 'image/*',
  addRemoveLinks: true,
  dictDefaultMessage: '拖曳檔案到此或點擊選擇'
};

遷移檢查清單

  • [ ] 移除所有 Uploadify 相關 JS/CSS/SWF 檔案
  • [ ] 後端改為接收 multipart/form-data (ASP.NET Core: IFormFile, Java: MultipartFile)
  • [ ] 前端改用 Fetch/XHR/FormData 上傳
  • [ ] 進度條改用 xhr.upload.onprogress 或 Uppy 內建事件
  • [ ] 測試大檔案、斷點續傳、並發上傳
  • [ ] 加入檔案類型驗證 (MIME + 副檔名雙重檢查)
  • [ ] 實作防 CSRF Token

總結

Uploadify 曾是 jQuery 時代最流行的上傳元件,但隨著 Flash 退出歷史舞台,已完成歷史使命。維護舊專案時可參考本文配置;新專案務必採用 HTML5 原生方案,獲得更好的相容性、安全性與使用者體驗。

copyright © 萬盛學電腦網 all rights reserved