【发布时间】:2021-02-26 07:30:29
【问题描述】:
我有一个如下所示的控制器方法:
/// <summary>
/// this message it works
/// </summary>
/// <param name="fromForm">from Form text</param>
/// <param name="fromQuery">from query text</param>
/// <returns>return text</returns>
[HttpGet("demo")]
public string Demo(
[FromForm] string fromForm,
[FromQuery] string fromQuery)
{
return "Message demo";
}
我使用来自Swashbuckle 的招摇 这是我在 swagger.json 中的输出,你可以看到不显示描述值
{
'/api/demo/': {
'get': {
'tags': [
'Demo'
],
'summary': 'this message it works',
'parameters': [
{
'name': 'fromQuery',
'in': 'query',
'description': 'from query text',
'schema': {
'type': 'string'
}
}
],
'requestBody': {
'content': {
'multipart/form-data': {
'schema': {
'type': 'object',
'properties': {
'fromForm': {
'type': 'string'
}
}
},
'encoding': {
'fromForm': {
'style': 'form'
}
}
}
}
}
}
}
}
注意:[FromQuery] 描述它可以正常工作来自标签/// 文本的消息,但 FromFrom 不显示描述
【问题讨论】:
-
你为什么不使用 Swashbuckle? docs.microsoft.com/en-us/aspnet/core/tutorials/… 那你就不用费心制作自己的swagger.json了。这一切都是自动化的。