【问题标题】：Empty model property description on ASP.NET Web API Help PagesASP.NET Web API 帮助页面上的空模型属性描述
【发布时间】：2016-07-23 06:45:07
【问题描述】：

简介

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

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

文档似乎很好，但我得到了空模型属性描述。

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

控制器方法示例

/// <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 属性摘要能够填充文档上的模型属性描述。相反，描述列是空的：

有人知道怎么解决吗？

【问题讨论】：

【解决方案1】：

您是否取消了 Areas/HelpPage/App_Start/HelpPageConfig.cs 中这行代码的注释：

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

【讨论】：

【解决方案2】：

你能用 Swashbuckle 代替 Microsoft.AspNet.WebApi.HelpPage。我发现 Swashbuckle 提供了更好的文档和友好的 UI 来探索你的 API。您也可以使用它来测试您的 API。

【讨论】：