虚张声势。AspNetCore[表单]IFormCollection

Question

我的中有以下操作。NET核心2控制器。它是一个API，应该存储作为应用程序/x-www-form-urlencoded发布的所有数据

[HttpPost("data/add/{formid}"]
public void Add(int formid, [FromForm]IFormCollection formData) {
    //do something
}

所以斯瓦格UI允许使用UI尝试这个动作：斯瓦格UI

但是SwaggerUI生成带有正文的POST：formData=field 1=value e1&field 2=value e2

我希望它是：field1=value1

所以问题是，这是OpenAPI的限制，还是SwaggerUI的错误？或者也许有一种方法可以得到我所期望的？

Answer 1

IFormCollection是一个动态字典，所以Swagger不知道如何处理它，因为它实际上没有规则。这本身应该足以向您发出信号，表明这不是您应该在基于REST的API中使用的东西。关键是使API自我文档化，这意味着它应该接受它需要的实际内容作为强类型参数，而不是泛型数据转储。

换言之，请执行以下操作：

public void Add(int formid, [FromForm]DataClass data)

其中，DataClass是一个实际的类，其属性与要发布的字段名称匹配。使用强类型参数并不排除作为应用程序/x-www-form-urlencoded发布。确实没有充分的理由使用IFormCollection。