如何用MultipartFormDataContent和ByteArrayContent向Asp.Net API传输含图片的复杂类型

1. 服务端无需修改现有配置 #

你定义的UserFormDataDto、UserDto以及标记了[FromForm]的Create Action完全符合要求，Asp.Net Core支持通过点符号命名表单字段来绑定嵌套对象，同时自动触发required等内置验证规则。

2. 客户端构造FormData的正确方式 #

不需要将UserDto序列化为JSON，直接为嵌套属性添加对应表单字段，格式为[外层属性名].[内层属性名]，同时添加文件字段即可。

JavaScript客户端示例： #

const formData = new FormData();

// 绑定嵌套UserDto的属性，用点符号关联
formData.append('UserDto.FirstName', 'John');
formData.append('UserDto.LastName', 'Doe');
formData.append('UserDto.FileName', 'profile.jpg'); // 可选字段

// 添加文件
const fileInput = document.querySelector('#fileInput');
if (fileInput.files.length > 0) {
    formData.append('FormFile', fileInput.files[0]);
}

// 发送请求
fetch('/api/Users/Create', {
    method: 'POST',
    body: formData
})
.then(response => response.json())
.catch(error => console.error(error));

C# HttpClient客户端示例： #

using var formData = new MultipartFormDataContent();

// 添加嵌套UserDto的字段
formData.Add(new StringContent("John"), "UserDto.FirstName");
formData.Add(new StringContent("Doe"), "UserDto.LastName");
formData.Add(new StringContent("profile.jpg"), "UserDto.FileName");

// 添加文件
using var fileStream = File.OpenRead("path/to/file.jpg");
formData.Add(new StreamContent(fileStream), "FormFile", "profile.jpg");

// 发送请求
var httpClient = new HttpClient();
var response = await httpClient.PostAsync("https://your-api-url/api/Users/Create", formData);
response.EnsureSuccessStatusCode();

3. 验证机制的生效与处理 #

Asp.Net Core会自动对required属性做校验，你只需在Action中检查ModelState.IsValid即可：

[HttpPost]
public async Task<ActionResult<UserDto>> Create([FromForm] UserFormDataDto createRequest)
{
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }

    // 业务逻辑处理
    return Ok(createRequest.UserDto);
}

如果客户端未提交UserDto.FirstName或UserDto.LastName，ModelState会直接标记为无效，返回包含错误信息的400响应，完全保留内置验证的能力。

关键原理 #

Asp.Net Core的表单模型绑定器支持复合对象的点符号字段命名，当表单字段名称匹配外层对象.内层属性格式时，会自动将值绑定到嵌套对象的对应属性上，同时触发数据注解的验证规则，不需要额外的序列化/反序列化操作。

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