.NET 5迁移时如何实现.NET Framework文件导出功能的.NET Core等效代码

ASP.NET Core 中对响应操作的API做了调整，以下是和你原有.NET Framework代码等效的两种实现方式：

方案一：Controller 场景推荐写法（最稳妥） #

框架自带的FileResult会自动处理所有响应头配置、内容写入、流释放逻辑，无需手动操作响应对象：

public IActionResult ExportTestFile()
{
    string output = "a very long string";
    // 按实际业务调整编码
    var contentBytes = System.Text.Encoding.UTF8.GetBytes(output);
    // 参数依次为：文件内容字节数组、MIME类型、下载文件名
    return File(contentBytes, "text/plain", "test.txt");
}

方案二：直接操作HttpContext.Response（适用于中间件、非Controller场景） #

如果你的场景无法直接返回IActionResult，可以直接操作响应对象，和原有写法逻辑对齐：

public async Task ExportTestFileAsync(HttpContext context)
{
    string output = "a very long string";
    var response = context.Response;
    
    // 清空原有响应内容和头
    response.Clear();
    // 配置对应响应头
    response.Headers.ContentLength = output.Length;
    response.ContentType = "text/plain";
    response.Headers.ContentDisposition = "attachment;filename=test.txt";
    
    // 写入内容，不需要手动调用End方法，请求管道结束时会自动完成响应发送
    await response.WriteAsync(output);
}

注意事项 #

• 不存在和Response.End()完全等效的方法，内容写入完成后无需手动终止响应，避免触发未处理异常
• 如果文件名包含中文，需要做编码处理避免乱码，可调整ContentDisposition配置为：$"attachment;filename*=UTF-8''{Uri.EscapeDataString("你的文件名.txt")}"
• 大文件导出场景建议直接传入流对象到File()方法，避免一次性加载全量内容到内存导致性能问题

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