Swagger响应描述未显示

Question

我目前正在尝试在Swagger UI中显示特定响应的描述，但似乎没有一个文档能够真正涵盖该问题的所有方面，我从Get started with Swashbuckle and ASP.NET Core尝试过的所有示例都没有”无法在.NET Core 3.1中工作...

        /// <summary>
        /// Test route...
        /// </summary>
        /// <returns></returns>
        /// <response code="200">This is a test</response>
        [HttpGet]
        [ProducesResponseType(typeof(string), StatusCodes.Status200OK)]
        public IActionResult Get()
        {
            return Ok("Hello World");
        }

我的.csproj也包含以下内容：

  <PropertyGroup>
    <GenerateDocumentationFile>true</GenerateDocumentationFile>
    <NoWarn>$(NoWarn);1591</NoWarn>
  </PropertyGroup>

Swagger UI最终看起来像这样（并且您可以看到，“ Descriptipn”列中不应该包含“ This is a test”文本）。我想念什么吗？

我还添加了[SwaggerResponse(StatusCodes.Status200OK, ...)]，但没有任何变化。

Answer 1

在项目属性中，您应检查在刀片Output XML documentation file下找到的Build。然后在您的startup文件中：

Answer 2

事实证明，[SwaggerResponse]正常工作，但是在此之前，我需要在“启动”中“启用注释” ...