7

在以前的 ASP.NET 版本中，当我创建 Web Api 2 时，Visual Studio 自动连接了 API 文档的自动生成。

这里也有解释： http ://www.asp.net/web-api/overview/getting-started-with-aspnet-web-api/creating-api-help-pages

我正在编写一个新项目，我决定使用 ASP.NET Core 来完成，但我没有看到任何类似于以前版本中存在的从 API 生成文档的东西（我也猜这是它有点不同，因为所有控制器现在都继承自同一个Controller类）。

但是，有没有办法为 ASP.NET Core API 生成帮助文件？

4

2 回答 2

6

您想要的功能位于https://github.com/domaindrivendev/Swashbuckle

以下链接提供了如何配置和使用精心设计的实用程序的示例 https://damienbod.com/2015/12/13/asp-net-5-mvc-6-api-documentation-using-swagger/

于 2016-08-03T02:08:36.180 回答
1

John Davidson 发表了一篇很好的文章，展示了如何生成 Swagger 文档——这很有用而且很棒。

但是如果你想坚持使用ASP.Net MVC 5 - Api Explorer 文档，你应该看看那篇优秀的博客文章：

https://andrewlock.net/introduction-to-the-apiexplorer-in-asp-net-core/

于 2018-02-05T20:57:58.753 回答