asp.net swagger的使用

最近要从其他系统获取一些数据，准备写个接口让别人把数据塞进来，顺便学习一下如何使用Swagger。

参考大神的教程：asp.net 　　　　 https://mp.weixin.qq.com/s/SHNNQoYF-t8i2j85E1oSYA

　　　　　　　　asp.net core 　　https://www.cnblogs.com/lhbshg/p/8711604.html

1.创建项目

2.添加NuGet，搜出来好多个，因为不是core项目，先选第一个试试

3.配置，对比了两篇参考的博客，asp.net 和 asp.net core 的流程好像不太一样。

　　对比一下项目结构，这个是之前练习的时候做的core的。

　　

　　这个是今天新建的项目，framework的。

　　

　　Core主要是在Startup.cs编辑 ConfigureServices类和Configure类，分别配置服务和启动Http中间件，具体过程我不贴了，直接进引用链接看吧。

　　今天主要学怎么用framework。

　　①Nuget添加完后自动添加的配置文件 SwaggerConfig.cs,里面可以修改版本号。

　　

　　②创建项目Xml注释文档

　　 右键项目→属性→生成→选中下方的 "XML文档文件" 然后保存

然后下面出了一堆警告，原因是Swagger吧一些接口的方法通过xml文件配置了，这些接口没有注释，可以手动去这些接口敲三个左斜杠/ 添加注释，或者通过配置过滤1591直接无视掉

③配置系统启动的时候，去读取这个xml文件

回到SwaggerConfig.cs 里面，加上这行配置，路径就是前面配置xml文件路径。

c.IncludeXmlComments(string.Format("{0}/bin/AMHS.API.xml", System.AppDomain.CurrentDomain.BaseDirectory));

去Controller里面添加注释后的效果