WebApi 生成帮助文档及顺便创建简单的测试工具

Posted Steven.Li

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了WebApi 生成帮助文档及顺便创建简单的测试工具相关的知识,希望对你有一定的参考价值。

http://www.2cto.com/kf/201607/522971.html

 ==========最终的效果图==========

技术分享

 

==========下面开始干活==========

一、创建 WebApi 项目

  技术分享

二、找到 HelpPageConfig.cs 并取消代码注释

  技术分享

  技术分享

 

1
1 config.SetDocumentationProvider( new XmlDocumentationProvider ( HttpContext.Current.Server.MapPath( "~/App_Data/XmlDocument.xml" )));

 

三、对项目单击右键,选择属性,按图操作

  技术分享

 

四、启动项目,输入Url: localhost:{端口号}/help

  技术分享

  技术分享

 

  【注】Description 没有显示内容是因为我们没有在对应的方法上面以 /// 的形式进行注释

 

==========下面是顺便创建简单测试工具的分割线==========

一、对项目单击右键,选择“管理 NuGet 程序包”,搜索一下“apitest”

  技术分享

二、装完之后再启动进去查看方法,就会发现右下角有个按钮“Test api”

  技术分享

 

以上是关于WebApi 生成帮助文档及顺便创建简单的测试工具的主要内容,如果未能解决你的问题,请参考以下文章

webAPI 加注释生成帮助文档和测试demo

如何使 WebAPI 自动生成漂亮又实用在线API文档

WebAPI使用多个xml文件生成帮助文档

WebAPI——自动生成帮助文档

.Net有没有自动生成WebAPI接口的网站或工具??

(转)WebApi自动生成在线文档Swashbuckle