1.创建webapi项目解决方案

WebAPI项目中使用SwaggerUI

 

2、引入Swagger组件

WebAPI项目中使用SwaggerUI

WebAPI项目中使用SwaggerUI

WebAPI项目中使用SwaggerUI

在项目引用中可以看到swagger的引用

WebAPI项目中使用SwaggerUI

 

 

3、webapi 项目右键属性->生成-> 勾选XML文档文件,然后将XML文件保存在项目bin目录下,后面swagger会读取XML文件用于UI展示

WebAPI项目中使用SwaggerUI

 

 

4、配置XML路径

swagger组件的引入自动为项目生成了配置代码,找到SwaggerConfig.cs 打开找到 c.IncludeXmlComments(GetXmlCommentsPath());

将其注释打开,表示需要加载XML文件,但此时GetXmlCommentsPath 方法是报错状态,需要我们去实现加载XML文件地址代码

WebAPI项目中使用SwaggerUI

接着在这个文件的下面,实现一下这个函数,XML文件名最好是与项目名一致

WebAPI项目中使用SwaggerUI

 

private static string GetXmlCommentsPath()
{
    return string.Format("{0}/bin/SwaggerUiDemo.XML", System.AppDomain.CurrentDomain.BaseDirectory);
}

 

5、解决运行报错

按照上面的步骤进行配置,应该是成功的才对,但是一运行就报错

WebAPI项目中使用SwaggerUI

网上查了一下资料,要打开swggernet文件,注释掉下面的两行代码。

WebAPI项目中使用SwaggerUI

 

再次运行,打开网页在URL后输入swagger即可访问api文档界面,URL形如:http://localhost:48914/swagger

WebAPI项目中使用SwaggerUI

 

相关文章:

  • 2021-07-16
  • 2022-01-28
  • 2022-03-07
  • 2021-11-02
  • 2022-12-23
  • 2022-12-23
  • 2022-12-23
  • 2021-10-09
猜你喜欢
  • 2022-02-17
  • 2022-12-23
  • 2022-12-23
  • 2022-12-23
  • 2021-07-30
  • 2021-03-07
  • 2018-08-17
相关资源
相似解决方案