ASP.NET Web API如何将注释自动生成帮助文档
ASP.NET Web API从注释生成帮助文档
默认情况下,ASP.NET Web API不从Controller的注释中生成帮助文档。如果要将注释作为Web API帮助文档的一部分,比如在帮助文档的Description栏目中显示方法注释中的summary,需要进行一些配置操作。
首先在Visual Studio中打开Web API项目的属性页,在Build设置页,选中XML document file,输入将要生成的XML文件放置的路径,比如:App_Data\OpenAPI.XML。

然后编译项目,就会在对应的路径下生成xml文件。
接着打开 Areas\HelpPage\App_Start\HelpPageConfig.cs 文件,取消 config.SetDocumentationProvider 代码的注释,修改一下路径:
然后重新编译,访问 /help 页面,就能看到效果了。
config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/OpenAPI.xml")))
通过以上的简单介绍,希望对大家有所帮助
相关文章
asp.net 读取Excel数据到DataTable的代码
asp.net 读取Excel数据到DataTable的代码,需要的朋友可以参考下。2010-03-03
Log4net在.Net Winform项目中的使用实例详解
Log4net是一个流行的日志记录工具,可以帮助开发人员在应用程序中实现高效的日志记录,本文将提供一个详细的分步骤示例,来帮助您在.Net Winform项目中使用Log4net,感兴趣的朋友一起看看吧2023-08-08
JQuery实现Repeater无刷新批量删除(附后台asp.net源码)
JQuery实现Repeater无刷新批量删除(附后台asp.net源码) ,学习jquery的朋友可以参考下。2011-09-09


最新评论