使用Ajax生成的Excel文件並下載

很久沒有寫文章啦，今天分享一個如何在ASP.NET MVC里使用Ajax下載生成文件的方法，以下只是個人心得：
 
大家都應該知道，在ASP.NET MVC里，如果通過Ajax調用後臺控制器時，可以返回一個JSON對象，但並不能直接返迴文件（除非刷新頁面，那就不是Ajax啦），所以如果想用Ajax生成文件並下載的話，那隻要將生成的文件先保存到服務器上，然後再將文件路徑通過JSON返回，之後才可以進行下載，當然由於是暫時性存放，所以當下載完後就需要馬上刪除相應的文件。
 
以下是做法以動態生成Excel為例（生成Excel的具體步驟我就省略了，這並不是此文章的重點）：
 
1. 首先創建Action生成Excel文件

[HttpPost]
public JsonResult ExportExcel()
{
    DataTable dt = DataService.GetData();
    var fileName = "Excel_" + DateTime.Now.ToString("yyyyMMddHHmm") + ".xls";
    //將生成的文件保存到服務器的臨時目錄里
    string fullPath = Path.Combine(Server.MapPath("~/temp"), fileName);
 
    using (var exportData = new MemoryStream())
    {
        //如何生成Excel這里就不詳細說明啦，我這里對Excel的操作使用的是 NPOI
        Utility.WriteDataTableToExcel(dt, ".xls", exportData);
 
        FileStream file = new FileStream(fullPath, FileMode.Create, FileAccess.Write);
        exportData.WriteTo(file);
        file.Close();
    }
 
    var errorMessage = "you can return the errors in here!";
 
    //返回生成的文件名
    return Json(new { fileName = fileName, errorMessage = "" });
}

 
2. 創建下載用的 Action

[HttpGet]
[DeleteFileAttribute] //Action Filter, 下載完後自動刪除文件，這個屬性稍後解釋
public ActionResult Download(string file)
{
    //到服務器臨時文件目錄下載相應的文件
    string fullPath = Path.Combine(Server.MapPath("~/temp"), file);
    //返迴文件對象，這里用的是Excel，所以文件頭使用了 "application/vnd.ms-excel"
    return File(fullPath, "application/vnd.ms-excel", file);
}

 
3. 由於要做到下載完後自動刪除文件，所以再創建一個 Action Filter 

public class DeleteFileAttribute : ActionFilterAttribute
{
    public override void OnResultExecuted(ResultExecutedContext filterContext)
    {
        filterContext.HttpContext.Response.Flush();
        //將當前filter context轉換成具體操作的文件並獲取文件路徑
        string filePath = (filterContext.Result as FilePathResult).FileName;
        //有文件路徑後就可以直接刪除相關文件了
        System.IO.File.Delete(filePath);
    }
}

 
4. 最後在前臺添加 Ajax 調用的代碼：

//這里我使用了 blockUI 做loading...
$.blockUI({ message: '<h3>Please wait a moment...</h3>' });    
$.ajax({
    type: "POST",
    url: '@Url.Action("ExportExcel","YourController")', //調用相應的controller/action
    contentType: "application/json; charset=utf-8",
    dataType: "json",
}).done(function (data) {
    //console.log(data.result);
    $.unblockUI();
    //接收返回的文件路徑，此文件這時已保存到服務器上了
    if (data.fileName != "") {
        //通過調用 window.location.href 直接跳轉到下載 action 進行文件下載操作
        window.location.href = "@Url.RouteUrl(new { Controller = "YourController", Action = "Download"})/?file=" + data.fileName;
    }
});

 
5. 完！