如何将 class 字段描述添加到 OpenAPI/Swagger class？

Question

如何在生成的 Swagger/OpenApi json 中包含 class 字段描述？

例如，我希望 swagger json 中的 class 属性包含描述

"properties": {
                 "customerId": {
                  "type": "string",
                  "description": "This is my foo foo foo"
              },

我原以为下面的代码会产生这个结果，但事实并非如此。它只包括 type

public class Customer
{
    [JsonRequired]
    [Description("This is my foo foo foo")]
    public string CustomerId { get; set; } }
}

Answer 1

在这种情况下，我能够使用 [OpenApiProperty(Description = "foo foo")]

如何将 class 字段描述添加到 OpenAPI/Swagger class？

How do you add class field description to a OpenAPI/Swagger class?

.net

swagger

.net-core

openapi