Web 文件上傳是經典需求。本文對比兩種 ASP.NET WebForms 實現方案:原生 <input type=file runat=server> 控件與封裝的 FileUpload 類,涵蓋前端表單配置、後端保存邏輯、文件命名衝突解決、數據庫記錄、安全注意事項。
<form method="post" enctype="multipart/form-data" runat="server">
<input id="PreviousFile1" type="file" size="49" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="上傳" OnClick="btnUpload_Click" />
<asp:Label ID="Label1" runat="server" />
</form>
enctype="multipart/form-data" 是上傳必須,否則 PostedFile 為 null。runat="server" 使 HTML 控件變為服務端控件,後端可直接訪問 PreviousFile1.PostedFile。protected void btnUpload_Click(object sender, EventArgs e) {
if (PreviousFile1.PostedFile.ContentLength == 0) return;
string basePath = @"D:\webFC\pic\";
DateTime now = DateTime.Now;
// 文件名:日期天數 + 文件大小 + .jpg,簡單防重名
string fileName = now.DayOfYear.ToString() + PreviousFile1.PostedFile.ContentLength + ".jpg";
string fullPath = basePath + fileName;
PreviousFile1.PostedFile.SaveAs(fullPath);
Label1.Text = $"圖片已上傳,文件名:{fileName}";
// 記錄到 XML(項目特定邏輯)
navigator.Insert(...);
navigator.Value = fileName;
}
web.config 中 <httpRuntime maxRequestLength="..." />(單位 KB,默認 4MB)。Server.MapPath("~/Uploads")。ContentType、擴展名、文件頭魔數,防惡意上傳。FileUpload(適用多文件、數據庫記錄)public class FileUpload {
public enum FileInfo { FILE_SIZE, FILE_POSTNAME, FILE_SYSNAME, FILE_ORGINNAME, FILE_PATH }
public static string[] UploadFile(HtmlInputFile file, string uploadDir) {
if (file.PostedFile.ContentLength <= 0) return null;
string uniqueName = GetUniqueName(); // 時間戳+隨機數
string ext = Path.GetExtension(file.PostedFile.FileName).TrimStart('.');
string originName = Path.GetFileName(file.PostedFile.FileName);
string savePath = Path.Combine(uploadDir, uniqueName + "." + ext);
file.PostedFile.SaveAs(savePath);
double sizeKB = Math.Round(file.PostedFile.ContentLength / 1024.0, 2);
return new string[] {
sizeKB.ToString(), ext, uniqueName, originName, savePath
};
}
public static bool OperateDB(string sql) { /* ADO.NET 執行 SQL */ }
private static string GetUniqueName() {
DateTime dt = DateTime.Now;
return $"{dt:yyyyMMdd_HHmmss_fff}_{new Random().Next(1000)}";
}
}
[HttpPost]
public async Task Upload(IFormFile file) {
if (file.Length == 0) return BadRequest();
var ext = Path.GetExtension(file.FileName);
var name = $"{Guid.NewGuid()}{ext}";
var path = Path.Combine(_env.WebRootPath, "uploads", name);
using (var stream = new FileStream(path, FileMode.Create))
await file.CopyToAsync(stream);
// 記錄數據庫、返回 JSON
return Ok(new { url = $"/uploads/{name}", size = file.Length });
}
IFormFile 替代 HttpPostedFileIWebHostEnvironment 獲取路徑Path.GetFileName 而非用戶輸入路徑方案一適合簡單頁面快速實現;方案二適合企業級項目,封裝性強、易擴展。無論哪種,核心原理相同:multipart/form-data 解析 → 臨時存儲 → 業務邏輯處理 → 持久化存儲 → 記錄元數據。現代開發推薦 ASP.NET Core + 前端組件(如 Dropzone、Uppy)實現分塊上傳、斷點續傳、進度顯示等高級體驗。