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
相关产品推荐
相关产品推荐

