使用 VS 来创建 WEB API 有个好处,它自动将 Help Page 帮你创建好了。这个 Help Page 的功能可大了去了,如果你一开始跟我一样对 Routing 这个功能不了解,你可以通过 Help 来看你的 Route 到底出了什么什么问题。
Anyway,如果自动创建好了 Help,那么还有什么好说的?
因为,虽然创建了 Help,但是它没自动将说明的功能启动起来。
天底下没有新鲜的事,这个问题网上早就有答案了 。 所以,谢谢互联网和 IT@找着了
简单说一下我怎么做的,如果使用了 Web API2 创建项目,那么应该自动就有了 Area 这个文件夹,里面包括了 HelpPage。
那么,只要2个步骤就可以了:
第一步
到 HelpPage/App_Start 里打开 HelpPageConfig.cs 这个文件,找到被注释了的这段代码,去掉注释
config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/XmlDocument.xml")));
第二步
进入项目属性,然后到 Build 这个界面里将 Output 下的 XML Documentation File 路径指到上面的 MapPath 值(App_Data/XmlDocument.xml)就可以了。
就可以了。如果没有启用,所有的 Description 就会跟第一行一样 - No documentation available 。