萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 檔案上傳三種方式完整比較:FileUpload、HtmlInputFile、Request.Files

ASP.NET Web Forms 提供三種檔案上傳方式,封裝層級與靈活度各異。本文詳細比較 `FileUpload` (Web 控制項)、`HtmlInputFile` (HTML 伺服器控制項)、`Request.Files` (原始集合) 的用法、差異與適用場景。

方式一:FileUpload 控制項 (最高封裝、最易用)

<!-- ASPX -->
<asp:FileUpload ID="fuFile" runat="server" />
<asp:Button ID="btnUpload" Text="上傳" OnClick="btnUpload_Click" runat="server" />
<asp:Label ID="lblMsg" runat="server" />
// CodeBehind
protected void btnUpload_Click(object sender, EventArgs e)
{
    if (fuFile.HasFile) // 內建 HasFile 屬性判斷
    {
        string savePath = Server.MapPath("~/Uploads/") + fuFile.FileName; // FileName 僅含檔名 (不含路徑)
        fuFile.SaveAs(savePath); // 簡單一行儲存
        lblMsg.Text = "上傳成功:" + fuFile.FileName;
    }
    else lblMsg.Text = "請選擇檔案";
}

方式二:HtmlInputFile (HTML 控制項、需 runat="server")

<!-- ASPX -->
<input type="file" id="htmlFile" runat="server" />
<asp:Button ID="btnUpload2" Text="上傳" OnClick="btnUpload2_Click" runat="server" />
protected void btnUpload2_Click(object sender, EventArgs e)
{
    // PostedFile 屬性對應 HttpPostedFile
    if (htmlFile.PostedFile.ContentLength > 0) // 無 HasFile,用 ContentLength > 0 判斷
    {
        // 注意:IE 會傳送完整路徑 (C:\path\file.jpg),Chrome/Firefox 僅檔名
        string fileName = Path.GetFileName(htmlFile.PostedFile.FileName); // 必須用 Path.GetFileName 統一取得檔名
        string savePath = Server.MapPath("~/Uploads/") + fileName;
        htmlFile.PostedFile.SaveAs(savePath);
        lblMsg.Text = "上傳成功:" + fileName;
    }
}

方式三:Request.Files 集合 (最原始、無需控制項宣告)

<!-- ASPX:表單必須加 enctype="multipart/form-data" -->
<form id="form1" runat="server" enctype="multipart/form-data">
    <input type="file" name="myFile" /> <!-- 純 HTML,無 runat="server" -->
    <asp:Button ID="btnUpload3" Text="上傳" OnClick="btnUpload3_Click" runat="server" />
</form>
protected void btnUpload3_Click(object sender, EventArgs e)
{
    HttpPostedFile postedFile = Request.Files["myFile"]; // 以 name 索引
    if (postedFile != null && postedFile.ContentLength > 0)
    {
        string fileName = Path.GetFileName(postedFile.FileName); // 同樣需 Path.GetFileName
        string savePath = Server.MapPath("~/Uploads/") + fileName;
        postedFile.SaveAs(savePath);
        lblMsg.Text = "上傳成功:" + fileName;
    }
}

三方式詳細比較

特性FileUploadHtmlInputFileRequest.Files
類型Web Server ControlHTML Server ControlHttpFileCollection (NameValueCollection)
封裝層級最高中最低 (原始)
檔名取得`FileName` (永遠只有檔名)`PostedFile.FileName` (瀏覽器差異大)`Request.Files[key].FileName` (瀏覽器差異大)
是否有檔案判斷`HasFile` (Boolean)`PostedFile.ContentLength > 0``Request.Files[key].ContentLength > 0`
儲存方法`SaveAs(path)``PostedFile.SaveAs(path)``Request.Files[key].SaveAs(path)`
表單編碼要求自動處理 (內部渲染 enctype)自動處理必須手動加 enctype="multipart/form-data"
多檔上傳支援單檔 (ASP.NET 4.5+ 支援 AllowMultiple)單檔原生支援多檔 `Request.Files` 集合遍歷
驗證整合可搭配 Validator 控制項較難整合完全手動
靈活度低 (生命週期綁定)中高 (動態表單、AJAX 上傳、Handler 處理)

進階:封裝通用上傳類別

public class UploadHelper
{
    public enum AllowedType { Jpg, Gif, Bmp, Png, Pdf, Doc, Docx, Xls, Xlsx }

    public static bool ValidateExtension(string fileName, AllowedType[] allowed)
    {
        string ext = Path.GetExtension(fileName).ToLower().TrimStart('.');
        return allowed.Any(t => t.ToString().ToLower() == ext);
    }

    public static string SaveFile(HttpPostedFile file, string saveDir, bool randomName = true)
    {
        if (file == null || file.ContentLength == 0) return null;
        
        string ext = Path.GetExtension(file.FileName);
        string fileName = randomName ? Guid.NewGuid().ToString("N") + ext : Path.GetFileName(file.FileName);
        string fullPath = Path.Combine(saveDir, fileName);
        
        Directory.CreateDirectory(saveDir);
        file.SaveAs(fullPath);
        return fileName; // 回傳儲存後檔名
    }

    // 文字浮水印 (需 System.Drawing)
    public static void AddTextWatermark(string imagePath, string text, string fontName = "微軟雅黑", int fontSize = 12)
    {
        using (var img = Image.FromFile(imagePath))
        using (var bmp = new Bitmap(img.Width, img.Height))
        using (var g = Graphics.FromImage(bmp))
        {
            g.DrawImage(img, 0, 0);
            var font = new Font(fontName, fontSize);
            var brush = new SolidBrush(Color.FromArgb(128, 255, 255, 255)); // 半透明白
            g.DrawString(text, font, brush, new PointF(10, img.Height - fontSize - 10));
            bmp.Save(imagePath); // 覆蓋原檔
        }
    }
}

使用建議

  1. 標準 Web Forms 頁面: 優先使用 `FileUpload`,簡潔安全。
  2. 動態產生上傳欄位 / AJAX 上傳 / HttpHandler 處理: 使用 `Request.Files`。
  3. 需精細控制渲染屬性: 使用 `HtmlInputFile`。
  4. ASP.NET 4.5+ 多檔上傳: ``,後端 `fuFile.PostedFiles` 遍歷。
  5. 大檔/分塊/斷點續傳: 必須使用 `Request.Files` 或 `HttpClient` 配合前端 Plupload/Uppy,搭配 `HttpHandler`/`Web API` 處理分塊合併。
  6. 安全性: 所有方式儲存前**必須**驗證副檔名白名單、Magic Number、檔案大小、隨機化檔名、儲存目錄移除執行權限。

理解三種方式的本質差異,才能根據專案需求 (簡單度 vs 靈活度) 做出正確選擇。

copyright © 萬盛學電腦網 all rights reserved