在 Intellisense 注释中显示空行答案

【问题标题】：Show empty lines in Intellisense comments在 Intellisense 注释中显示空行
【发布时间】：2013-11-15 04:54:14
【问题描述】：

首先我想澄清一下这个问题是关于VB.NET，不是C#，这个问题不是重复的，因为任何解决方案都可以从这里How to add a line break in C# .NET documentation或Adding line breaks to comments for 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（有和没有官方更新）上测试断线标记。

【问题讨论】：

Multiline XML Comments in VB.Net and Visual Studio Intellisense的可能重复
@Hans Passant 只是一个题外话：我敢肯定，如果您不知道该怎么做，那么不存在任何可能的方法。但奇怪的是，Visual Studio 产品团队从评论链接中关闭了该问题，但没有提供任何解决方案！。
考虑使用 ReSharper。它可以正确显示 XML 文档 cmets（它同时支持 br 和 para，IIRC）并包含更多可以提高您的工作效率的功能。没有 R# 的 VS 很烂。

标签： .net xml vb.net visual-studio-2012 intellisense

【解决方案1】：

我的第一个想法是使用

<para>foo</para>

因为这在 VS2008 中可用于 cmets 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 这样的文档生成工具会观察空格

【讨论】：

试过但没有解决问题，我的 CDATA summay 行被智能感知忽略：''' <![CDATA[ something ]]> 也许我做错了。

【解决方案2】：

您可以使用 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>

【讨论】：

对不起，但似乎 VB.NET 由于某种原因不支持格式化标签。谁能想到。
@edokan 不适合我img41.imageshack.us/img41/3343/9t3h.jpg 在 Windows 8 x64 的 VS2012 Ultimate（有和没有官方更新）上测试。在浅色和深色主题上对其进行了测试。你能提供更多关于你的环境的细节吗？
@ElektroStudios 这实际上可能是我的错。我在 W7 x64 上使用 WS2012，但我还安装了 ReSharper 8 EAP，它改变了游戏规则。很抱歉造成混乱。
我的环境是VS2010 / Resharper 7.1

【解决方案3】：

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

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

【讨论】：

不，在 VS2012 中没有。我已经测试过了
创建一个空行，是 Unicode 不间断空格字符。