asp.net-web-api-helppages

WebAPI Help Pages: disable for Production release

荒凉一梦 提交于 2019-11-27 15:59:04
问题 I have developed a number of internal REST interfaces using the older WCF framework in VS 2010. The ability for it to generate help pages was handy for DEV and QA platforms, but for a production release it was easy to disable the generation of these help pages in the web.config file: <standardEndpoint name="" helpEnabled="false" automaticFormatSelectionEnabled="true"/> I am now moving on to use the WebAPI framework instead (currently version 1 on VS 2012), but it doesn't appear to be as

Web Api Help Page XML comments from more than 1 files

北战南征 提交于 2019-11-27 10:48:36
问题 I have different plugins in my Web api project with their own XML docs, and have one centralized Help page, but the problem is that Web Api's default Help Page only supports single documentation file new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/Documentation.xml")) How is it possible to load config from different files? I wan to do sth like this: new XmlDocumentationProvider("PluginsFolder/*.xml") 回答1: You can modify the installed XmlDocumentationProvider at

WebApi Help Page: don't escape HTML in XML documentation

泄露秘密 提交于 2019-11-27 04:25:33
问题 I am using XML Documentation for my ASP.NET Web API Help Page as shown here. I would like to know if there is a way to include html in the comments such that it will be rendered on the web page, instead of it being removed/ignored/escaped. Specifically, I am looking for a way to create a newline, but being able to create bulleted lists, etc. would be great! Ex/ I would like to be able to do something like this: /// <summary> /// CRUD operations for SalesDocument<br/> /// This is a new line //