WebApi 帮助页面：不要在 XML 文档中转义 HTML

Question

我正在为我的 ASP.NET Web API 帮助页面 as shown here 使用 XML 文档。 我想知道是否有一种方法可以在 cmets 中包含 html，以便将其呈现在网页上，而不是被删除/忽略/转义。
具体来说，我正在寻找一种创建换行符的方法，但能够创建项目符号列表等会很棒！

Ex/我希望能够做这样的事情：

/// <summary>
/// CRUD operations for SalesDocument<br/>
/// This is a new line
/// </summary>
[RoutePrefix("api/SalesDocument")]
public partial class SalesDocumentController : ApiController

并让它像这样显示在帮助页面上：

CRUD operations for SalesDocument 
This is a new line.

而不是这个：（在这种情况下，<br/> 以某种方式被删除 - 如果我尝试使用 <p> 标记，它们只是被转义）

CRUD operations for SalesDocument This is a new line.

*我已经尝试了多个帖子建议的工具提示<para>标签，但这在我的帮助页面上不起作用。

非常感谢任何建议！

Answer 1

在已安装的XmlDocumentationProvider.cs 文件Areas\HelpPage 中，您可以查找名为GetTagValue 的方法。这里将返回值从node.Value.Trim()修改为node.InnerXml。

private static string GetTagValue(XPathNavigator parentNode, string tagName)
{
    if (parentNode != null)
    {
        XPathNavigator node = parentNode.SelectSingleNode(tagName);
        if (node != null)
        {
            return node.InnerXml; 
        } 
    }

    return null;
}

现在打开已安装的文件Areas\HelpPage\Views\Help\DisplayTemplates\ApiGroup.cshtml 并修改以下行：

<p>@controllerDocumentation</p>

到

<p>@Html.Raw(controllerDocumentation)</p>

Answer 2

@controllerDocumentation 对我不起作用，但将行更改为@api.Documentation 可以。即@html.raw(api.Documentation)。