ASP.NET MVC控制器实现附件下载而非在线预览的方法

要将文件从预览改为直接下载，只需修改控制器中的File返回结果，添加下载文件名参数，并优化相关代码即可。以下是具体步骤和修改后的代码：

1. 修改控制器代码 #

核心变化是使用File方法的三个参数重载，第三个参数指定下载时的文件名，这会让浏览器触发下载而非预览。同时优化数据库查询，减少不必要的数据库访问：

public ActionResult RetrieveTaskImage(int id)
{
    // 一次性获取完整的TaskFile记录，优化查询效率
    var taskFile = db.TaskFiles.FirstOrDefault(c => c.Id == id);
    
    if (taskFile == null || taskFile.Attachment == null)
    {
        return HttpNotFound(); // 返回404替代null，更符合REST规范
    }

    string fileName = taskFile.File_Name;
    string fileExtension = Path.GetExtension(fileName).ToLowerInvariant();
    byte[] fileBytes = taskFile.Attachment;

    // 根据扩展名获取正确的MIME类型
    string contentType = GetContentType(fileExtension);

    // 第三个参数指定下载文件名，触发浏览器下载行为
    return File(fileBytes, contentType, fileName);
}

// 辅助方法：根据文件扩展名返回对应的MIME类型
private string GetContentType(string extension)
{
    return extension switch
    {
        ".pdf" => "application/pdf",
        ".jpg" or ".jpeg" => "image/jpeg",
        ".png" => "image/png",
        ".gif" => "image/gif",
        ".doc" => "application/msword",
        ".docx" => "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
        // 可根据需要添加更多文件类型
        _ => "application/octet-stream" // 未知类型默认使用二进制流
    };
}

2. 修正HTML ActionLink的动作名称 #

确保ActionLink中指定的动作名称与控制器方法名一致（原代码中存在名称不匹配的问题）：

@Html.ActionLink(item.File_Name, "RetrieveTaskImage", "TaskMains", new { id = item.Id }, null)

• 移除了target="_blank"，因为下载操作不需要新标签页（保留也不会有问题，但没必要）。
• 确保动作名称"RetrieveTaskImage"与控制器中的方法名完全一致。

关键原理说明 #

当使用File方法的三个参数重载时，ASP.NET MVC会自动在响应头中添加Content-Disposition: attachment; filename="xxx"，这个头信息告诉浏览器将文件作为附件下载，而非在页面中预览。

内容的提问来源于stack exchange，提问作者Dev Beginner