萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# Web 文件上傳兩種方案:基礎控件與封裝類完整實現

Web 文件上傳是經典需求。本文對比兩種 ASP.NET WebForms 實現方案:原生 <input type=file runat=server> 控件與封裝的 FileUpload 類,涵蓋前端表單配置、後端保存邏輯、文件命名衝突解決、數據庫記錄、安全注意事項。

方案一:原生 File Field 控件

前端關鍵配置

<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;
}

注意事項

  1. 文件大小限制:web.config 中 <httpRuntime maxRequestLength="..." />(單位 KB,默認 4MB)。
  2. IIS 權限:上傳目錄需寫入權限,應用程序池標識需訪問權限。
  3. 安裝部署路徑:避免硬編碼絕對路徑,用 Server.MapPath("~/Uploads")。
  4. 重名處理:示例用日期+大小,生產建議 GUID + 原始擴展名。
  5. 類型驗證:檢查 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)}";
    }
}

優勢

  • 邏輯封裝,頁面代碼簡潔
  • 統一命名策略,避免衝突
  • 返回結構化信息,便於入庫、日誌、前端回顯
  • 可擴展:添加圖片壓縮、病毒掃描、雲存儲上傳等

現代化遷移:ASP.NET Core

[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 替代 HttpPostedFile
  • 異步流複製,非阻塞
  • 依賴注入 IWebHostEnvironment 獲取路徑

安全最佳實踐清單

  1. 限制擴展名白名單(.jpg,.png,.pdf...)
  2. 驗證 MIME 類型與文件頭一致
  3. 文件重命名存儲,不暴露原始路徑
  4. 上傳目錄禁用腳本執行權限(IIS Handler Mappings / nginx location)
  5. 設置請求體大小限制
  6. 病毒掃描(ClamAV / 云安全 API)
  7. 防止路徑遍歷:Path.GetFileName 而非用戶輸入路徑

總結

方案一適合簡單頁面快速實現;方案二適合企業級項目,封裝性強、易擴展。無論哪種,核心原理相同:multipart/form-data 解析 → 臨時存儲 → 業務邏輯處理 → 持久化存儲 → 記錄元數據。現代開發推薦 ASP.NET Core + 前端組件(如 Dropzone、Uppy)實現分塊上傳、斷點續傳、進度顯示等高級體驗。

copyright © 萬盛學電腦網 all rights reserved