首页 > Windows开发 > 详细

WEBAPI 自动生成帮助文档

时间:2015-06-29 19:56:38      阅读:339      评论:0      收藏:0      [点我收藏+]

需求来源

WEBAPI开发过程中发现一个蛋疼的问题,给其他人员使用的时候还得整理文档,而API函数本身是有注释的,于是想到可以利用注释生成API帮助文档。

生成文档方法

1、安装Microsoft.AspNet.WebApi.HelpPage

Install-Package Microsoft.AspNet.WebApi.HelpPage

2、选中项目,右键,属性,生成,选择下面的XML 文档文件,目录自己填写,如下图:

技术分享

3、找到 Areas/HelpPage/App_Start 目录下的HelpPageConfig.cs 文件,Register 方法,添加一行代码:

 config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/Areas/HelpPage/WebApiHelp.XML")));

4、重新生成然后访问即可

http://xxx.com/Help

 

WEBAPI 自动生成帮助文档

原文:http://www.cnblogs.com/shya/p/4608183.html

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!