.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);

前后端配合示例（HTML）

一个简单的上传页面：

  
  上传文件


下载示例文件

基本上就这些。只要掌握 IFormFile 和 File 结果的使用，再注意安全规范，.NET 中实现文件上传下载并不复杂但容易忽略细节。