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

Question

我有一个控制器操作，它接受对象数组（称为复杂对象ControlLinePointDto）形式的数据。由于我在此处的问答中描述的原因，我将其读为 aJArray而不是 a 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