萬盛學電腦網

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

ASP.NET 整合 jQuery Uploadify 上傳插件完整教學

Uploadify 是經典的 jQuery 檔案上傳插件(Flash-based),支援多檔、進度條、佇列管理。官方範例為 PHP,本文詳細說明 ASP.NET (WebForms) 整合步驟與參數對照。

專案結構

JQueryUploadDemo/
├── JS/jquery.uploadify-v2.1.0/     # 插件檔案
├── UploadHandler.ashx              # 後端處理器
├── UploadFile/                     # 儲存目錄
└── Default.aspx                    # 前端頁面

專案結構圖

Default.aspx 關鍵代碼

<head runat="server">
  <link href="JS/jquery.uploadify-v2.1.0/example/css/default.css" rel="stylesheet" />
  <link href="JS/jquery.uploadify-v2.1.0/uploadify.css" rel="stylesheet" />
  <script src="JS/jquery.uploadify-v2.1.0/jquery-1.3.2.min.js"></script>
  <script src="JS/jquery.uploadify-v2.1.0/swfobject.js"></script>
  <script src="JS/jquery.uploadify-v2.1.0/jquery.uploadify.v2.1.0.min.js"></script>
  <script>
  $(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>
</head>
<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>

UploadHandler.ashx 核心邏輯

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"); // 關鍵:回傳 1 讓前端佇列移除項目
    } else {
        context.Response.Write("0");
    }
}

執行效果

Uploadify 介面圖

核心參數對照表

參數說明預設值
uploaderuploadify.swf 路徑uploadify.swf
script後端處理器路徑uploadify.php
fileDataName伺服端取檔案的鍵名Filedata
methodPOST/GETPOST
folder儲存目錄(相對路徑)-
queueID佇列容器 ID-
multi多檔上傳false
auto選檔即上傳false
fileDesc檔案選擇框提示文字(需配合 fileExt)-
fileExt允許副檔名,如 '*.doc;*.pdf;*.rar'-
sizeLimit檔案大小限制(bytes)-
simUploadLimit同時上傳數1
buttonText瀏覽按鈕文字BROWSE
cancelImg佇列項目關閉圖示-
wmodetransparent 可讓 Flash 透明並置頂opaque

回調函數參數

  • onSelect(event, queueID, fileObj) — 選檔時
  • onComplete(event, queueID, fileObj, response, data) — 完成時
  • onError(event, queueID, fileObj, errorObj) — 錯誤時

注意: Uploadify 依賴 Flash,現代專案建議改用 HTML5 上傳方案(如 Fine Uploader、Dropzone、Uppy)。

copyright © 萬盛學電腦網 all rights reserved