.NET怎么实现文件的上传和下载功能_文件上传下载实现教程_技术教程

答案：ASP.NET Core通过IFormFile处理上传，FileResult实现下载。首先前端表单需设置enctype为multipart/form-data，后端用IFormFile接收文件，保存至指定目录；下载时验证文件存在性，读取字节流并返回FileStreamResult，设置Content-Disposition响应头触发下载。安全方面应限制文件类型与大小，重命名文件为GUID避免冲突，推荐存储至云服务如Blob或S3。示例代码包含上传接口/post upload和下载接口/get download/{fileName}，配合HTML表单可完成基本功能。

.NET 实现文件的上传和下载功能在 Web 开发中非常常见，尤其是在 ASP.NET Core 项目中。通过简单的控制器方法和 I/O 操作，就能高效安全地处理文件传输需求。下面介绍如何在 ASP.NET Core 中实现文件的上传与下载功能。

文件上传实现

文件上传通常通过表单提交，使用 IFormFile 接口来接收前端传来的文件数据。

步骤如下：

在前端页面创建支持文件上传的表单，设置 enctype="multipart/form-data"
后端控制器定义接收文件的方法，参数类型为 IFormFile
将文件保存到服务器指定目录，并可返回上传结果

示例代码：

[HttpPost("upload")]
public async Task Upload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("文件为空");

    var uploadDir = Path.Combine(Directory.GetCurrentDirectory(), "uploads");
    Directory.CreateDirectory(uploadDir); // 确保目录存在

    var filePath = Path.Combine(uploadDir, file.FileName);
    
    await using (var stream = new FileStream(filePath, FileMode.Create))
    {
        await file.CopyToAsync(stream);
    }

    return Ok(new { message = "上传成功", fileName = file.FileName });
}

文件下载实现

文件下载是将服务器上的文件以流的形式返回给客户端，触发浏览器下载行为。

关键点：

验证文件是否存在
使用 FileStreamResult 返回文件流
设置合适的响应头（如 Content-Disposition）

示例代码：

[HttpGet("download/{fileName}")]
public IActionResult Download(string fileName)
{
    var filePath = Path.Combine(Directory.GetCurrentDirectory(), "uploads", fileName);

    if (!System.IO.File.Exists(filePath))
        return NotFound("文件未找到");

    var fileBytes = System.IO.File.ReadAllBytes(filePath);
    return File(fileBytes, "application/octet-stream", fileName);
}

说明：返回 File() 方法会自动设置响应类型，第三个参数为下载时的默认文件名。

安全性与优化建议

实际项目中需注意以下几点：

限制上传文件类型（如只允许 .jpg、.pdf）
限制文件大小（可在 Program.cs 或中间件中配置）
对文件名进行重命名，防止路径遍历或覆盖攻击
使用 GUID 生成唯一文件名，避免冲突
考虑将文件存储到云存储（如 Azure Blob、AWS S3）而非本地磁盘

例如重命名文件：

var fileExtension = Path.GetExtension(file.FileName);
var newFileName = Guid.NewGuid() + fileExtension;
var filePath = Path.Combine(uploadDir, newFileName);