.net - 在 Intellisense 注释中显示空行

Question

首先我想澄清一下，这个问题是关于VB.NET，不是 C#，这个问题不是重复的，因为任何解决方案都可以从这里开始如何在 C# .NET 文档中添加换行符或在 Intellisense 的注释中添加换行符（至少在VS2012） .

我想添加一个空行来显示如下Intellisense信息：

Public Enum StringCase As Short

''' <summary>
''' LowerCase
''' (Empty line)
''' [Example]   + (line break)
''' Input : ABC + (line break)
''' Output: abc
''' </summary>
Lower = 0

End Enum

更新：

在 Windows 8 x64 中使用浅色和深色主题对 VS2012 Ultimate（有和没有官方更新）上的断线标签进行测试。

Answer 1

您可以使用 HTML<br/>标签来创建空行和换行。

这适用于 C#

    /// <summary>
    /// LowerCase
    /// <br/><br/>
    /// [Example]<br/>
    /// Input<br/>
    /// Output<br/>
    /// </summary>

在 VB 中它应该像：

    ''' <summary>
    ''' LowerCase
    ''' <br/><br/>
    ''' [Example]<br/>
    ''' Input<br/>
    ''' Output<br/>
    ''' </summary>

Answer 2

我的第一个想法是使用

<para>foo</para>

因为这在 VS2008 中可用于评论 http://social.msdn.microsoft.com/Forums/en-US/5dce48f5-d810-46bd-bb9b-6d0478174cf2/xml-comments-how-to-insert-a-new -line?forum=csharpide

您是否考虑过将您的评论放在 CDATA 或类似文件中以尝试保留空白？

http://msdn.microsoft.com/en-us/library/vstudio/ms255811(v=vs.100).aspx

IIRC 它更像是 IDE 的格式设置，但是我认为像 Doxygen 这样的文档生成工具会观察空格

Answer 3

如果您将要中断的行包含在“para”标签中，它应该做您想做的事情。

''' <summary>
''' LowerCase
''' <para></para>
''' <para>[Example]</para>
''' <para>Input</para>
''' <para>Output</para>
''' </summary>