You need to enable JavaScript to run this app. ASP.NET Core Razor Pages中如何获取表单上传文件作为邮件附件?
优惠活动
大模型
产品
解决方案
定价
更多

ASP.NET Core Razor Pages中如何获取表单上传文件作为邮件附件?

问题根源定位

你现在通过Request.Form["inputFile"]只能拿到文件名称,核心原因通常是两个:

  • 承载文件上传input的<form>标签没有配置enctype="multipart/form-data"属性,这种情况下浏览器只会把文件的名称作为普通表单字段提交,不会传输文件的二进制内容
  • 对ASP.NET Core的文件接收API存在认知偏差,框架本身没有沿用旧版Request.Files的写法,上传的文件内容本身就不会存在Request.Form的普通字段集合里,只会单独存放在Request.Form.Files集合中
Razor Pages 场景下的可行实现

1. 基础表单配置修复

不管用哪种方式接收文件,首先要确保上传控件所在的完整表单结构符合要求:

  • 在<form>标签上必须加上enctype="multipart/form-data"属性,这是浏览器支持文件上传的硬性要求
  • 保证type="file"的input控件的name属性和后续服务端接收的参数名完全一致,比如设置name="inputFile"
  • 因为input放在部分视图中,要确认部分视图渲染后没有出现表单嵌套、enctype属性丢失的问题,不要把上传控件拆到独立的表单块外

2. 服务端接收文件的两种方式

强类型自动绑定(推荐)

在对应的PageModel类中,直接定义和input名称对应的IFormFile类型公共属性,框架会自动把上传的文件内容绑定到这个属性上,不需要手动读取请求内容:

// PageModel中的属性,注意名称和input的name对应
public IFormFile InputFile { get; set; }

// 处理POST请求的方法中直接使用
public async Task<IActionResult> OnPostAsync()
{
    if (InputFile == null || InputFile.Length == 0)
    {
        // 未上传文件的处理逻辑
        return Page();
    }
    // 拿到完整文件对象后即可后续处理
}

手动从请求中读取

如果不想使用强类型绑定,可以直接从请求的表单文件集合中读取内容,这是ASP.NET Core原生的API,不存在旧版框架的Request.Files写法:

public async Task<IActionResult> OnPostAsync()
{
    // 从Form.Files集合中按name取对应的上传文件
    IFormFile file = Request.Form.Files["inputFile"];
    if (file == null || file.Length == 0)
    {
        return Page();
    }
}

3. 将文件作为邮件附件加载的实现

拿到IFormFile对象后,不需要强制把文件先保存到服务器磁盘,可以直接读取内存中的文件流生成邮件附件,减少IO开销:

// 直接打开上传文件的只读流
await using var fileStream = file.OpenReadStream();
// 生成邮件附件,自动匹配文件名和文件类型
var mailAttachment = new System.Net.Mail.Attachment(
    contentStream: fileStream,
    name: file.FileName,
    contentType: file.ContentType.MediaType
);
// 把附件加入邮件消息实体即可正常发送
常见踩坑提醒
  • 如果使用前端JS异步提交表单,不要用普通的字符串序列化方式传参数,要通过FormData对象原生携带文件内容,否则同样会出现只传文件名不传文件的问题
  • 不要依赖Request.Form集合获取文件内容,这个集合只存普通文本字段,所有上传的二进制文件内容都统一存放在Request.Form.Files中

内容的提问来源于stack exchange,提问作者Almaran

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 12:24:04