ASP.NET Web Forms 提供三種檔案上傳方式,封裝層級與靈活度各異。本文詳細比較 `FileUpload` (Web 控制項)、`HtmlInputFile` (HTML 伺服器控制項)、`Request.Files` (原始集合) 的用法、差異與適用場景。
<!-- 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 = "請選擇檔案";
}
<!-- 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;
}
}
<!-- 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;
}
}
| 特性 | FileUpload | HtmlInputFile | Request.Files |
|---|---|---|---|
| 類型 | Web Server Control | HTML Server Control | HttpFileCollection (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); // 覆蓋原檔
}
}
}
理解三種方式的本質差異,才能根據專案需求 (簡單度 vs 靈活度) 做出正確選擇。