zoukankan      html  css  js  c++  java
  • (转)创建WebAPI文档的3个简单步骤

    默认情况下,Microsoft.AspNet.WebApi.HelpPage创建的API帮助页不包含任何文档。 我们会看到所有的ApiController动作都列在No documentation available.

    要启用文档,我们只需要遵循三个简单步骤。

    步骤1-在控制器级别上

    为了测试目的,创建了一个新的ApiController,名为DocumentationsController

    
    public class DocumentationsController : ApiController
    {
     // GET api/documentation
     public IEnumerable<string> Get()
     {
     return new string[] {"value1","value2" };
     }
    ....
    

    在控制器操作前点击///以获取文档。

    
    // GET api/documentation
    /// <summary>
    /// This is how we create a documentation
    /// </summary>
    /// <returns></returns>
    public IEnumerable<string> Get()
    ....
    

    有关可以记录的内容的详细信息,可以按"<"来出现IntelliSense,或转到MSDN页面

    步骤2-生成属性

    调出项目属性页,并且设置文档的xml输出,在本例中,文档文件将是App_DataDocumentation.XML

    步骤3- HelpPage配置

    若要将HelpPageConfig设置为使用我们的文档xml文件,请转到~AreasHelpPageHelpPageConfig.cs

    默认情况下,config.SetDocumentationProvider语句被注释掉,使用该语句,并将DocumentationProvider的位置指向我们的xml文件:

    
    public static void Register(HttpConfiguration config)
    {
     // Uncomment the following to use the documentation from XML documentation file.
     config.SetDocumentationProvider(
     new XmlDocumentationProvider(
     HttpContext.Current.Server.MapPath("~/App_Data/Documentation.xml")));
    

    现在我们可以做一个构建和刷新api documenation页面:略

    其它参考资料:https://www.cnblogs.com/AntonWang/p/5208655.html

    解决swagger跨程序集问题:https://www.cnblogs.com/ricolee/p/swagger-summary.html

  • 相关阅读:
    20170602
    使用布局规划页面
    商品的删除
    修改页面的 修改图片
    商品修改
    引入行高亮显示
    添加一个时间插件: 1.把插件放到 public目录 下 datetimepicker
    排序,搜索 代码
    搜索
    翻页代码,商品列表页;
  • 原文地址:https://www.cnblogs.com/hhhh2010/p/12605579.html
Copyright © 2011-2022 走看看