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的文章都会归类在里面.