NSwag - 为控制器操作中的预期数据提供附加信息

Question

我有一个控制器动作，它接受对象数组形式的数据（称为ControlLinePointDto 的复杂对象）。由于我的问答here 中描述的原因，我将其读入JArray 而不是ControlLinePointDto[]。我在多个地方使用不同的对象执行此操作。

如何更改文档 (NSwag) 以将其记录为（包括示例）ControlLinePointDto[]，而不是 []？

[HttpPost("AddPoints")]
[ProducesResponseType(typeof(List<ControlLinePointDto>), 200)]
public async Task<IActionResult> AddPoints(int ControlLineId, [FromBody] JArray pointSetJson){
}

Answer 1

您可以通过这种方式更改文档类型：

[JsonSchemaType(typeof(MyDto[]), FromBody] JArray array

https://github.com/RSuter/NJsonSchema/blob/master/src/NJsonSchema/Annotations/JsonSchemaTypeAttribute.cs#L19