Visual Studio 2017:<list>在悬停时无法正确显示(XML文档)

时间:2018-11-14 11:05:26

标签: c# visual-studio visual-studio-2017 xml-comments

如果将鼠标悬停在VS17(15.6.2)中具有xml文档(///<summary></summary>)的内容(类,方法等)上,则会弹出此小弹出窗口,显示正确格式化的注释。

我试图列出一个列表(从here复制):

/// <summary>Here is an example of a bulleted list:
/// <list type="bullet">
/// <item>
/// <description>Item 1.</description>
/// </item>
/// <item>
/// <description>Item 2.</description>
/// </item>
/// </list>
/// </summary>

但是弹出窗口仅将其显示为一行:

Here is an example of a bulleted list: Item 1. Item 2.

我还尝试向其中添加<term>(例如here),但我得到的只是:

enter image description here

我也尝试了其他type(也没有尝试),但是没有任何变化。这是错误吗?我该如何解决?

1 个答案:

答案 0 :(得分:1)

这是我的解决方法:

/// <summary>Here is an example of a bulleted list:
/// <list type="bullet">
/// <item>
/// <description><para>&#x02022; Item 1.</para></description>
/// </item>
/// <item>
/// <description><para>&#x02022; Item 2.</para></description>
/// </item>
/// </list>
/// </summary>