C# WebAPI能否在函数签名中解构请求体参数？

可以实现无需单独定义DTO类，直接在函数签名中处理请求体参数，同时省去手动提取的步骤，以下是两种可行方案：

方案1：命名元组+解构绑定（类型安全推荐） #

ASP.NET Core支持将请求体直接绑定到命名元组，只要客户端JSON的键名与元组元素名匹配（大小写不敏感）。这样可以直接在函数签名中声明参数，再通过解构快速获取所需值：

[HttpPost("user-login")]
public async Task<IActionResult> InsertOrUpdateUserLogin([FromBody] (PersonalizationUserLogin UserLogin, int Tracker) requestData)
{
    var (userLogin, tracker) = requestData;

    // 执行插入/更新用户登录信息的逻辑
    // ...

    return Ok("操作成功完成");
}

客户端保持原有请求结构即可：

{
  "userLogin": { /* PersonalizationUserLogin 对应的字段结构 */ },
  "tracker": 123
}

方案2：动态类型+直接提取（快速灵活） #

如果不想在签名中声明元组，也可以用dynamic类型接收请求体，直接提取并转换类型：

[HttpPost("user-login")]
public async Task<IActionResult> InsertOrUpdateUserLogin([FromBody] dynamic requestData)
{
    PersonalizationUserLogin userLogin = requestData.userLogin;
    int tracker = requestData.tracker;

    // 执行插入/更新用户登录信息的逻辑
    // ...

    return Ok("操作成功完成");
}

注意事项 #

• 命名元组方案具备编译时类型检查，适合生产环境使用；动态类型方案灵活性高，但缺乏类型校验，需注意类型转换异常。
• 确保PersonalizationUserLogin类的属性与客户端发送的userLogin字段完全匹配，否则会出现参数绑定失败。

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