asp.net-web-api - ASP.NET Web API 帮助页面上的空模型属性描述

Question

简介

我关注了this tutorial设置我的 ASP.NET Web API 帮助页面。

使用 <package id="Microsoft.AspNet.WebApi.HelpPage" version="5.2.3" targetFramework="net452" />

文档似乎没问题，但我得到的是空模型属性描述。

它们在 Controller 方法/端点和模型详细信息文档中都是空的。

Controller 方法示例

/// <summary>
/// POST: api/remitent
/// </summary>
/// <param name="remitent"></param>
public void Post([FromBody]Remitent remitent)
{

}

模型属性示例

/// <summary>
/// First name property summary
/// </summary>
[Required]
[MaxLength(49)]     
public string FirstName { get; set; }

结果

我希望 FirstName 属性摘要能够填充文档中的模型属性描述。相反，描述列是空的:

---

有人知道怎么解决吗？

Answer 1

您是否在 Areas/HelpPage/App_Start/HelpPageConfig.cs 中取消注释这行代码:

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