ASP.NET Core文件上傳與下載(多種上傳方式)

前言

前段時間項目上線,實在太忙,最近終於開始能夠研究研究ASP.NET Core了.

打算寫個系列,可是還沒想好目錄,今天先來一篇,後面在整理吧.

ASP.NET Core 2.0 發展到如今,已經很成熟了.下個項目爭取使用吧.

 

正文

1.使用模型綁定上傳文件(官方例子)

官方機器翻譯的地址:https://docs.microsoft.com/en-us/aspnet/core/mvc/models/file-uploads

這裏吐槽一下 - -,這TM的機器翻譯..還不如本身看E文的..

首先咱們須要建立一個form表單以下:

    <form method="post" enctype="multipart/form-data" asp-controller="UpLoadFile" asp-action="FileSave">
        <div>
            <div>
                <p>Form表單多個上傳文件:</p>
                <input type="file" name="files" multiple />
                <input type="submit" value="上傳" />
            </div>
        </div>
    </form>

其中,asp-controller和asp-action,(這個是TagHelper的玩法,之後講)是咱們要訪問的控制器和方法.

給咱們的input標籤加上 multiple 屬性,來支持多文件上傳.

建立一個控制器,咱們編寫上傳方法以下:

 public async Task<IActionResult> FileSave(List<IFormFile> files)
        {
            var files = Request.Form.Files;
            long size = files.Sum(f => f.Length);
            string webRootPath = _hostingEnvironment.WebRootPath;
            string contentRootPath = _hostingEnvironment.ContentRootPath;
            foreach (var formFile in files)
            {
                if (formFile.Length > 0)
                {

                    string fileExt = GetFileExt(formFile.FileName); //文件擴展名，不含「.」
                    long fileSize = formFile.Length; //得到文件大小，以字節爲單位
                    string newFileName = System.Guid.NewGuid().ToString() + "." + fileExt; //隨機生成新的文件名
                    var filePath = webRootPath +"/upload/" + newFileName;
                    using (var stream = new FileStream(filePath, FileMode.Create))
                    {
                        
                        await formFile.CopyToAsync(stream);
                    }
                }
            }

            return Ok(new { count = files.Count, size });
        }

這裏咱們採用Asp.NET Core的新接口IFormFile,  IFormFile的具體定義以下:

public interface IFormFile
{
    string ContentType { get; }
    string ContentDisposition { get; }
    IHeaderDictionary Headers { get; }
    long Length { get; }
    string Name { get; }
    string FileName { get; }
    Stream OpenReadStream();
    void CopyTo(Stream target);
    Task CopyToAsync(Stream target, CancellationToken cancellationToken = null);
}

上面的代碼使用了IHostingEnvironment來獲取項目的根目錄地址.

構造函數注入的代碼以下:

        private readonly IHostingEnvironment _hostingEnvironment;

        public UpLoadFileController(IHostingEnvironment hostingEnvironment)
        {
            _hostingEnvironment = hostingEnvironment;
        }

這樣,咱們就完成了控制器的編寫,而後到運行前端,上傳文件..效果以下:

經過IFormFile的CopyToAsync方法,咱們就能夠把這個文件流複製下來並保存到本地便可.

 

2.使用Ajax上傳文件

上面咱們是使用表單上傳,可是項目過程當中,大部分狀況會使用Ajax進行上傳,因此咱們就來說講如何使用Ajax上傳.

首先編寫HTML代碼以下:

<div>
    <form id="uploadForm">
        AJAX上傳多文件： <input type="file" name="file" multiple />
        <input type="button" value="上傳" onclick="doUpload()" />
    </form>
</div>

編寫JS代碼以下(這裏咱們使用FormData對象來上傳):

 function doUpload() {
        var formData = new FormData($("#uploadForm")[0]);
        $.ajax({
            url: '@Url.Action("FileSave")',
            type: 'POST',
            data: formData,
            async: false,
            cache: false,
            contentType: false,
            processData: false,
            success: function (returndata) {
                alert(returndata);
            },
            error: function (returndata) {
                alert(returndata);
            }
        });
        }

後臺代碼不作任何修改.咱們會發現.直接在List<IFormFile> files中是沒法獲取到文件的.

經過調試,咱們能夠發現,文件是上傳成功的,可是放在了Request.Form.Files當中.

因此修改後臺代碼以下:

public async Task<IActionResult> FileSave()
{
            var date = Request;
            var files = Request.Form.Files;
            long size = files.Sum(f => f.Length);
            string webRootPath = _hostingEnvironment.WebRootPath;
            string contentRootPath = _hostingEnvironment.ContentRootPath;
            foreach (var formFile in files)
            {
                if (formFile.Length > 0)
                {

                    string fileExt = GetFileExt(formFile.FileName); //文件擴展名，不含「.」
                    long fileSize = formFile.Length; //得到文件大小，以字節爲單位
                    string newFileName = System.Guid.NewGuid().ToString() + "." + fileExt; //隨機生成新的文件名
                    var filePath = webRootPath +"/upload/" + newFileName;
                    using (var stream = new FileStream(filePath, FileMode.Create))
                    {
                        
                        await formFile.CopyToAsync(stream);
                    }
                }
            }

            return Ok(new { count = files.Count, size });
 }

改成直接從Request.Form.Files中獲取文件集合.~

 

3.使用webUploader上傳文件

好久以前..呃..封裝過一個webUploader的JS.以下:

對百度WebUploader開源上傳控件的二次封裝,精簡前端代碼(兩句代碼搞定上傳)

對百度WebUploader的二次封裝,精簡前端代碼之圖片預覽上傳(兩句代碼搞定上傳)

..咱們也用封裝好的JS來試試.HTML和JS代碼以下,後臺代碼不須要修改,仍是直接從Request.Form.Files獲取便可:

<div id="upfliediv"></div>

$(function () {


        //實例化文件上傳

        $("#upfliediv").powerWebUpload({
                auto: true, fileNumLimit: 1
            });
        $("#upfliediv").CleanUpload();

    })

上傳效果如圖:

 

4.文件下載.

上傳了文件,咱們固然須要下載.

直接經過URL+地址下載是一種極其不安全的方式.這裏咱們採用返回流的形式來下載.

後臺代碼以下:

 

        /// <summary>
        /// 文件流的方式輸出        /// </summary>
        /// <returns></returns>
        public IActionResult DownLoad(string file)
        {
            var addrUrl = file;
            var stream = System.IO.File.OpenRead(addrUrl);
            string fileExt = GetFileExt(file);
            //獲取文件的ContentType
            var provider = new FileExtensionContentTypeProvider();
            var memi = provider.Mappings[fileExt];
            return File(stream, memi, Path.GetFileName(addrUrl));
        }  

這裏值得注意的是,之前咱們想獲取ContentType直接使用MimeMapping.GetMimeMapping(file);就行了.

可是這個類是在System.Web下的,core已經拋棄了現有的System.Web.

因此在ASP.NET Core中咱們須要經過新的類FileExtensionContentTypeProvider來獲取文件的ContentType

編寫HTML+JS代碼以下(PS:由於是demo,因此寫的比較簡陋):

<div>
    <input type="text" id="filename" /><button onclick="downLoad()">下載</button>
</div>

 function downLoad() {
            var filename = $("#filename").val();
            window.location.href = "@Url.Action("DownLoad")?file=" + filename;

        }

效果如圖:

 

 

 

寫在最後

到此,本篇就結束了,感興趣的,請點個關注或者推薦.~謝謝.博客也新增了ASP.NET Core的分類文章,之後關於ASP.NET Core的文章都會歸類在裏面.