ASP.NET Web API集成Swagger(1)-安装与简单配置
分类:
文章
•
2024-09-29 14:27:52
建立Web API项目
- 新建项目–>ASP.NET MVC4项目–>WebAPI

NuGet中搜索安装 Swashbuckle
- 打开NuGet管理控制台命令安装Swashbuckle
install-package Swashbuckle
-

配置项目属性
- 直接从NuGet中安装Swashbuckle,而且并不想做更多的定制,那么UI界面就不用做更多的处理,所有的资源Resources都是嵌入到Swashbuckle.DLL中的(其中还包括css/js/images等静态文件),可以在VS的对象资源管理器中看到
- 安装完成之后App_Start中会多一个SwaggerConfig这样一个配置文件,这个文件是Swagger为我们留下的配置入口,我们可以根据其中的注释和介绍做很多事情。把Swagger单独出来一个文件夹,直接将配置类拖进去,整理一下,如下效果:
- 配置项目属性:
选择项目–>属性–>生成选项卡:按照如下图中将输出项中XML文档文件项勾选,保存。
- 配置文件SwaggerConfig.cs中主要有两个入口:EnableSagger和EnableSwaggerUi,顾名思义,配置其后台项和前台项。
- 找到配置文件中的IncludeXmlComments方法,配置读取XML的路径:

c.IncludeXmlComments(string.Format("{0}/bin/SwaggerDemo.XML", System.AppDomain.CurrentDomain.BaseDirectory));
测试配置是否成功
- 运行调试项目
- 访问项目路径:
http://localhost:18247/swagger
