根据
this article,可以获得多行XML注释 – 而不是使用///,使用/ ** * /。这是我对多行评论的解释,以及我想要发生的事情:
/** * <summary> * this comment is on line 1 in the tooltip * this comment is on line 2 in the tooltip * </summary> */
但是,当我使用这种形式时,当我在我的代码中悬停在我的类名称时弹出的工具提示是单行的,即它看起来完全像我写了我的评论:
/// <summary> /// this comment is on line 1 in the tooltip /// this comment is on line 2 in the tooltip /// </summary>
这个行为在VS2008仍然可能吗?
编辑
gabe指出,我误解了“多线”的含义,我实际上需要使用< para>或< br>以获得我预期的效果。我继续使用< br>因为我想控制线断裂发生的位置,即
/// <summary> /// this comment is on line 1 in the tooltip<br/> /// this comment is on line 2 in the tooltip<br/> /// </summary>
当我看到我的代码中的这个类的工具提示,一切仍然结束在一行… WTH?我在这里做错了吗?
更新
好的,我继续尝试< para>标签,并且工作。不确定为什么< br />没有。
/// <summary> /// <para>this comment is on line 1 in the tooltip</para> /// <para>this comment is on line 2 in the tooltip</para> /// </summary>