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

Question

介绍

我已按照本教程设置我的 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 属性摘要能够填充文档上的模型属性描述。相反，描述列是空的：

有谁知道如何解决这个问题？

score 2 · Accepted Answer

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

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

score 0 · Accepted Answer

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