核心原则

服务器端代码（如 C#）负责读取文件内容，然后通过 HTTP 响应（Response 对象）将文件内容发送给客户端，客户端的浏览器接收到这些数据后，会根据其内容类型（Content-Type处置（Content-Disposition）来决定下一步操作。

强制下载（最常用、最安全）

这种方法最通用,适用于任何类型的文件，它会强制浏览器下载文件，而不是尝试在浏览器内打开，可以避免因文件类型（如 .exe, .config）或浏览器安全策略导致的问题。

关键点：

1. Response.ContentType: 设置文件的 MIME 类型，如果不知道或想通用，可以设置为 application/octet-stream（二进制流），这会告诉浏览器这是一个未知类型的文件，应该下载。
2. Response.AddHeader("Content-Disposition", "attachment; filename=...": 这是最关键的。
   • attachment: 表示这是一个附件，应该下载。
   • filename=...: 指定下载时用户看到的文件名，建议使用 HttpUtility.UrlPathEncode 或 Server.UrlEncode 来处理文件名中的特殊字符（如中文、空格），确保跨浏览器兼容性。
3. Response.TransmitFile: 高效地将文件内容写入 HTTP 响应流，这是推荐使用的方法，因为它不会将整个文件读入服务器内存。
4. Response.End(): 结束响应，确保后续代码不会执行。

C# 代码示例 (Web Forms)

// 在 Page_Load 或按钮点击事件中
protected void DownloadFileButton_Click(object sender, EventArgs e)
{
    // 1. 定义服务器上的文件路径
    // 使用 Server.MapPath 将虚拟路径转换为服务器物理路径
    string filePath = Server.MapPath("~/App_Data/MyReport.pdf");
    // 2. 检查文件是否存在
    if (!File.Exists(filePath))
    {
        // 文件不存在，可以显示错误信息或重定向
        Response.Write("文件不存在！");
        return;
    }
    // 3. 获取文件名（不含路径）
    string fileName = Path.GetFileName(filePath);
    try
    {
        // 4. 设置响应头，强制浏览器下载
        // application/octet-stream 是通用类型，表示任意二进制数据
        Response.ContentType = "application/octet-stream";
        // 使用 UrlEncode 处理文件名中的特殊字符（如中文、空格）
        Response.AddHeader("Content-Disposition", "attachment; filename=\"" + HttpUtility.UrlPathEncode(fileName) + "\"");
        // 5. 将文件写入响应输出流
        // TransmitFile 方法高效，不占用服务器内存
        Response.TransmitFile(filePath);
        // 6. 结束响应，防止后续代码执行
        Response.End();
    }
    catch (Exception ex)
    {
        // 处理可能的异常，如文件被占用
        Response.Write("下载文件时发生错误: " + ex.Message);
    }
}

C# 代码示例 (ASP.NET MVC / Razor Pages)

在 Razor Pages 中，你可以在 PageModel 中创建一个处理方法。

// 在 PageModel 中 ( Pages/Download.cshtml.cs)
public class DownloadModel : PageModel
{
    public IActionResult OnGet()
    {
        // 1. 定义文件路径
        string filePath = Path.Combine(_environment.WebRootPath, "files", "MyReport.pdf");
        // 2. 检查文件是否存在
        if (!System.IO.File.Exists(filePath))
        {
            return NotFound(); // 返回 404 Not Found
        }
        // 3. 获取文件名
        string fileName = Path.GetFileName(filePath);
        // 4. 返回文件
        // File 方法会自动处理 Content-Type 和 Content-Disposition
        // 第一个参数是文件路径，第二个参数是 Content-Type，第三个参数是下载文件名
        return File(filePath, "application/octet-stream", fileName);
    }
}

在 MVC Controller 中也是类似的，使用 return File(...)。

尝试在浏览器中打开（适用于图片、PDF、文本等）

对于某些浏览器支持的文件类型（如 .jpg, .png, .pdf, .txt），你可以尝试让浏览器直接打开它们。

关键点：

1. Response.ContentType: 必须设置为正确的 MIME 类型。
   • 图片: image/jpeg, image/png
   • PDF: application/pdf
   • 文本: text/plain
   • HTML: text/html
2. 不设置 Content-Disposition 为 attachment: 如果省略此头，或者设置为 inline，浏览器会尝试使用内置或插件来显示文件。

C# 代码示例 (Web Forms)

protected void ViewPdfButton_Click(object sender, EventArgs e)
{
    string filePath = Server.MapPath("~/App_Data/MyReport.pdf");
    string fileName = Path.GetFileName(filePath);
    if (!File.Exists(filePath))
    {
        Response.Write("文件不存在！");
        return;
    }
    // 设置正确的 MIME 类型
    Response.ContentType = "application/pdf";
    // 可选：设置文件名，这样浏览器下载时也会用这个名字
    // 但这里浏览器会尝试打开，而不是下载
    Response.AddHeader("Content-Disposition", "inline; filename=\"" + HttpUtility.UrlPathEncode(fileName) + "\"");
    Response.TransmitFile(filePath);
    Response.End();
}

重要注意事项和最佳实践

1. 安全性 (Security):

   • 绝对不要将用户提供的文件名直接用于路径拼接！这会导致路径遍历攻击 (Path Traversal Attack)。
   • 错误的做法: string filePath = "C:\Files\" + Request.QueryString["fileName"]; 攻击者可以通过 fileName=../../windows/win.ini 来访问服务器上的敏感文件。
   • 正确的做法: 总是使用 Server.MapPath 将一个固定的、安全的虚拟路径转换为物理路径，或者将文件名白名单化。

2. 性能 (Performance):

   • 优先使用 Response.TransmitFile: 它能直接将文件流式传输到客户端，不会将整个文件加载到服务器的内存中，对于大文件，这至关重要。
   • 避免 Response.WriteFile 或 File.ReadAllBytes: ReadAllBytes 会将整个文件读入一个字节数组，如果文件很大（几百MB或GB），会消耗大量服务器内存，甚至导致应用程序崩溃。

3. 异常处理 (Exception Handling):

   • 总是使用 try...catch 块来包裹文件操作，可能发生的异常包括：文件不存在、文件被其他进程占用、权限不足等。
   • 向用户返回友好的错误信息,而不是暴露服务器详细的错误堆栈。

4. 文件名编码 (Filename Encoding):

   
   （图片来源网络，侵删）
   • 当文件名包含非英文字符（如中文、日文、俄文）或空格时，必须进行 URL 编码，以确保所有浏览器都能正确显示下载文件名。HttpUtility.UrlPathEncode 是一个好选择。

对于新的 ASP.NET Core 项目，逻辑是相似的，但 API 和对象名称有所不同（使用 IActionResult 和 File() 辅助方法），但核心原理——将文件作为 HTTP 响应流发送——是完全一致的。