asp.net-mvc-5 - ASP.NET 网络 API : Help Description not generated for classes in referenced project

Question

我能够设置 Web API 帮助，它确实会生成帮助页面。但是，没有记录具有在不同项目中定义的类型属性的响应和请求类类型。

这是示例代码:

    /// <summary>
    /// Add New Product
    /// </summary>
    /// <param name="productRequest">The new Product Request to be added</param>
    /// <returns>Operation status and information of the new product request</returns>
    // POST api/InventorySystem/Products
    [Route("")]
    [HttpPost]
    public InsertProductResponse Post([FromBody]InsertProductRequest productRequest)
    {
        InsertProductResponse response = null;

        // Some code goes here
        response = new InsertProductResponse ();

        return response;
    }

帮助页面确实包含描述“添加新产品”。但是，当深入到“InsertProductResponse”对象时，没有任何描述。

InsertProductResponse 在单独的类库中定义，并且为此类定义了 XML 文档。但是在帮助页面上看不到。

我在想类库生成的 XML 文档没有与 Web API 项目 (App_Data/XmlDocument.xml) 生成的 XML 文档合并。我如何让它发挥作用？

Answer 1

知道了 - 需要更改帮助区中的一些代码。引用这篇文章

How can Xml Documentation for Web Api include documentation from beyond the main project?