c# - Swagger.NET MVC API 异常

Question

我一直在寻找提供自动生成的 API 文档的不同选项，而 Swagger 似乎就在那里。

然而，当我第一次尝试这个时，我在启动时遇到了异常。

运行 Visual Studio 2013。
创建新的 Web API 项目。
使用包管理器，运行：

Install-Package Swagger.Net & Install-Packager Swagger.Net.UI

确保我们启用了 XML 文档，我们得到了这个异常：

Method 'GetDocumentation' in type 'Swagger.Net.XmlCommentDocumentationProvider' 
from assembly 'Swagger.Net, Version=0.5.1.0, Culture=neutral, PublicKeyToken=null' 
does not have an implementation.

有其他人知道我们缺少的步骤吗？我们发现并遵循了这个：
https ://github.com/Swagger-Net/Swagger.Net/wiki
https://github.com/Swagger-Net/Swagger.Net/blob/master/README.md

Answer 1

Swagger 不支持 .NET 4.5 - 必须从 git 中获取源代码并对其进行修改以使用 4.5。

右键单击项目并在其中设置目标框架

Answer 2

我制作了一个与 mvc 一起使用的库，它根据属性为您生成文档。它可能是您正在寻找的东西。

• MVC3：https ://www.nuget.org/packages/SwaggerAPIDocumentation/
• MVC4：https ://www.nuget.org/packages/SwaggerAPIDocumentation.Mvc4/
• MVC5：https ://www.nuget.org/packages/SwaggerAPIDocumentation.Mvc5/
• MVC5.1：https ://www.nuget.org/packages/SwaggerAPIDocumentation.Mvc51/

github上的存储库中有文件，只需单击项目站点链接。希望这可以帮助

Answer 3

尝试使用 Swashbuckle。

据我所知，基于 Swagger，它第一次对我有用......

https://github.com/domaindrivendev/Swashbuckle