asp.net web api帮助文档的说明

为asp.net的mvc web api填写自己的帮助文档

1. 加入Help的area(能够通过命令行或其它方式加入)

命令行:Install-Package Microsoft.AspNet.WebApi.HelpPage

NuGet搜索:HelpPage,找到Microsoft asp.net web api help page

asp.net web api帮助文档的说明_第1张图片

2. 为api等加入凝视

asp.net web api帮助文档的说明_第2张图片

3. 生成凝视为xml文件

asp.net web api帮助文档的说明_第3张图片

asp.net web api帮助文档的说明_第4张图片

4. 将xml赋予Help的configuration

    在help的config文件里 HelpPageConfig.Register(HttpConfiguration config):

config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/sfa.web.XML")));


 

5. debug查看

 

6. 可选:在帮助页面加入測试工具

參考:http://blogs.msdn.com/b/yaohuang1/archive/2012/12/02/adding-a-simple-test-client-to-asp-net-web-api-help-page.aspx

asp.net web api帮助文档的说明_第5张图片

asp.net web api帮助文档的说明_第6张图片

你可能感兴趣的:(asp.net web api帮助文档的说明)