ASP.NET Web API从注释生成帮助文档 ASP.NET Web API怎样将注释自动生成帮助文档(aspnet是前端还是后端)

网友投稿 313 2022-06-06


想了解ASP.NET Web API怎样将注释自动生成帮助文档的相关内容吗,dudu在本文为您仔细讲解ASP.NET Web API从注释生成帮助文档的相关知识和一些Code实例,欢迎阅读和指正,我们先划重点:ASP.NET,注释,帮助文档,下面大家一起来学习吧。

 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。

接着打开 Areas\HelpPage\App_Start\HelpPageConfig.cs 文件,取消 config.SetDocumentationProvider 代码的注释,修改一下路径:

然后重新编译,访问 /help 页面,就能看到效果了。

复制代码 代码如下:

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

通过以上的简单介绍,希望对大家有所帮助



版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。

上一篇:C#利用Windows API读写INI文件 C#实现利用Windows API读写INI文件的方法(c罗)
下一篇:android通过Location API显示地址信息 android通过Location API显示地址信息的实现方法(android通过http分享文件)
相关文章

 发表评论

暂时没有评论,来抢沙发吧~