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){ } ？

{{1}}

Answer 1

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

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

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