asp.net-core - 如何在 Swagger UI 的 multipart/form-data 中的 json 参数中显示架构？

Question

我正在使用 OpenApi 3.0 和 Swagger UI。

(如果重要的话，Swashbuckle 和 ASP.Net Core)

我有 multipart/form-data其中有 2 个参数:

ProductToAdd JSON 中的对象描述

Image作为文件。

我定义了模式和示例。

现在我设法做到了


我的目标是这样的:



我的问题是如何呈现第二张图片中的模式和示例？
我在 swagger.json 等中没有发现任何有用的东西。

附言。如果您好奇，请完美地执行工作。

@编辑

我为此制作了 nuget 包。你可以找到它 here

Answer 1

当前(截至 2019 年 9 月)Swagger UI 未在 multipart/* 中显示对象类型字段的架构请求，它只显示这些字段的示例值。这是相应的功能请求:

Display static documentation information for multipart properties in OpenAPI 3.0 files