如何使 ASP.NET WEB API HELP PAGES Xml 文档注释具有新行
•浏览 1
How to make ASP.NET WEB API HELP PAGES Xml Documentation Comments to have new line
我有一个使用 ASP.NET WEB API 开发的 rest api。我使用帮助页面 nuget 包来创建文档。我遇到的一个问题如下。对于我的模型对象，我有 xml 文档注释，它们成为模型每个成员的帮助页面上的描述。我希望描述的某些部分位于新的一行，但评论中的所有内容都作为一个段落出现。我试图在评论中添加 <br/> ，但没有帮助。有谁知道如何做到这一点？
此处已提出类似问题：Web Api Help Page- don't escape html in xml documentation and the accepted answer(由 Kiran Challa - ASP.NET Web API 团队成员之一给出)描述了一项工作周围。
我自己试过了，效果很好。
但是，我没有将 <br/> 添加到我的代码注释中，而是将建议的解决方案从：
return node.InnerXml;
到：
return node.InnerXml.Replace("\
\
","<br/>").Replace("\
","<br/>");
...正如评论中所指出的，您可能需要在几个地方添加 @Html.Raw()，即 ApiGroup.cshtml、HelpPageApiModel.cshtml 和 ResourceModel.cshtml 以及一些部分视图.
为了弄清楚我必须更改哪些视图，我基本上只是在 Chrome 中启动了调试器来帮助我检查 html 并根据它定位要更改的文件。