ASP.NET 下載文件自定義文件名：Content-Disposition header 設置

需求：用戶請求 /sqlExcel/goods.xls，下載彈窗顯示「主表.xls」。

核心方案：動態輸出流 + 設置 Header

public void DownloadExcel() {
    string filePath = Server.MapPath("~/sqlExcel/goods.xls");
    if (!System.IO.File.Exists(filePath)) {
        Response.StatusCode = 404; return;
    }

    Response.Clear();
    Response.ContentType = "application/vnd.ms-excel";
    // 關鍵：指定下載文件名，UTF-8 編碼防中文亂碼
    string fileName = "主表.xls";
    string encodedName = System.Web.HttpUtility.UrlEncode(fileName, System.Text.Encoding.UTF8);
    Response.AddHeader("Content-Disposition", $"attachment; filename=\"{encodedName}\"; filename*=UTF-8''{encodedName}");

    Response.TransmitFile(filePath); // 高效發送文件，不佔用內存
    Response.End();
}

關鍵點解析

ASP.NET Core 寫法

public IActionResult Download() {
    var path = Path.Combine(_env.ContentRootPath, "sqlExcel", "goods.xls");
    var bytes = System.IO.File.ReadAllBytes(path); // 或 FileStream
    return File(bytes, "application/vnd.ms-excel", "主表.xls");
    // File() 內部自動設置 Content-Disposition 與編碼
}

避坑提醒

• 不要用 Response.WriteFile（舊版本大文件會 OOM），用 TransmitFile 或 FileStream 分塊輸出。
• 中文文件名**必須雙重編碼**（filename + filename*）全兼容。
• 若文件需動態生成（如 EPPlus/NPOI），直接寫入 Response.OutputStream 並設置相同 Header。

掌握 Content-Disposition 雙編碼模板，文件下載重命名場景全覆蓋。

1. 上一篇文章： C 語言去除數組重復元素：正確邏輯與常見錯誤對比
2. 下一篇文章： C++ 冒泡排序數組越界修復：下標從 0 開始、長度邊界條件修正

程式設計綜合問答

Java ServerSocket.accept() 迴圈機制：單一 Socket 維持長連線

程式碼片段 while (true) { Socke

ExtJS 時間元件取值並精確顯示至分鐘的實作指南

在 ExtJS 應用開發中，時間選擇元件預設可能包含秒數，若

JSP 圖片無法顯示：本地路徑 vs Web 根目錄路徑

現象 JSP 中 <img src=D:/projec

Java 數獨生成算法：回溯法填充 9x9 九宮格滿足行列宮唯一性

算法核心：回溯 + 隨機化 按行掃描每個格子。 從候選數字