在 AspNet WebApi 帮助页面中生成模型描述

我如何生成一个描述对于 Asp.Net Web Api 帮助页面中的我的模型？

Example:

正如您从示例中看到的，我已经可以生成Name, Type and Additional Information。但我如何生成Description?

我什么也没尝试，我已经没有想法了。

不，那不是真的。我尝试过向我的TransactionDto类，但它不起作用。

/// <summary>
/// A DTO (Data Transfer Object) for Transaction objects.
/// </summary>
public class TransactionDto
{
    /// <summary>
    /// The manager who registered the transaction.
    /// </summary>
    public string FromId { get; set; }

    /// <summary>
    /// The receiving manager.
    /// </summary>
    [Required]
    public string ToId { get; set; }

    /// <summary>
    /// Optional expiration date.
    /// </summary>
    public DateTime? Expires { get; set; }

    /// <summary>
    /// Date the transaction was created.
    /// </summary>
    public DateTime Created { get; set; }
}

我已经配置了HelpPageConfig.cs使用XmlDocumentationProvider像这样：

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

那么如何生成模型的这些描述呢？

我相信除了 Web API 项目之外，您在单独的项目中还有模型吗？

如果是这种情况，则 Web API 项目不知道为模型生成的帮助 XML 文件。您需要为Web API项目和模型项目设置XML输出路径，然后在HelpPageConfig.cs文件的register方法中合并这两个XML文件。

public static void Register(HttpConfiguration config)
{
        XmlDocument apiDoc = new XmlDocument();
        apiDoc.Load(HttpContext.Current.Server.MapPath("~/App_Data/WebApi.Orders.xml"));
        XmlDocument contractsDoc = new XmlDocument();
        contractsDoc.Load(HttpContext.Current.Server.MapPath("~/App_Data/Contracts.xml"));
        if (contractsDoc.DocumentElement != null && apiDoc.DocumentElement!=null)
        {
            XmlNodeList nodes = contractsDoc.DocumentElement.ChildNodes;
            foreach (XmlNode node in nodes)
            {
                XmlNode copiedNode = apiDoc.ImportNode(node, true);
                apiDoc.DocumentElement.AppendChild(copiedNode);
            }
            apiDoc.Save(HttpContext.Current.Server.MapPath("~/App_Data/WebApi.Orders.xml"));
        }
        config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/WebApi.Orders.xml")));
    ......
}