.Net WebAPI 增加Swagger

第一部分:创建项目

选择Web/ASP.NET Web Application

这里我选择的是WebAPI,并且增加MVC和Web API,权限部分选择无权限

 

 


 

第二部分:增加EF连接

因为项目需要连接至SQL Server,在Web API项目中增加EF是比较好的选择。

因为数据已经是存在的,所以选择DB first

创建新的数据库连接

选择数据源为SQL Server

输入数据库信息,并连接至数据库

选择将当前连接字符串包含至项目中

选择需要导入的数据库对象,这里我们不需要选择任何的数据库对象,因为只需要从系统中运行SQL语句获取相应的数据即可。

 

 


第三部分:增加Swagger引用

在项目解决方案中,鼠标右键,选择管理NuGet包

在包查询时输入swashbuckle,并点击进行安装

安装时,会需要选择引用的项目

安装中

安装完成后,会发现在项目文件夹App_Start会加入一个新文件SwaggerConfig.cs

找到该行,将前面的注释删除即可

并且创建新的方法

创建的方法如下

暂时不修改方法中的代码,打开项目属性

项目默认配置,点击以下XML documentation file

选择后,并使用默认的文件名,也可以修改其中的文件名,将其中的路径加文件名复制至之前的方法

将项目属性中配置的XML文档位置加入至方法中

 

posted @ 2017-12-25 10:43  WesChan  阅读(565)  评论(0编辑  收藏  举报