有没有人知道如何在摘要注释中插入换行符,以便在Intellisense文档中反映换行符?
为了澄清,假设代码文档..
/// <summary>
/// Some text documentation
/// - a line break -
/// Some more documentation
/// </summary>
public void SomeMethod() { }
Run Code Online (Sandbox Code Playgroud)
因此,当使用此方法时,Intellisense提供了这样格式化的方法的摘要:
一些文字文件
更多文档
(注意 - 'para'标签不会创建空换行符 - 我已经尝试过了!)
我正在尝试在VB.Net中的XML注释中添加换行符.我读过另外两篇关于C#的帖子,
但建议<para>或<br/>标签不起作用.这个,
''' <summary>
''' <para>Line one</para><br />
''' <para>Line two</para><br />
''' </summary>
''' <value></value>
''' <returns></returns>
''' <remarks></remarks>
Public Property Speed As Double
Run Code Online (Sandbox Code Playgroud)
仍然看起来像这样:

我怎样才能做到这一点?
当我在Visual Studio 2015 Community Edition中使用<para></para>文档中的标记(也以同样的形式<para />)时,我在IntelliSense工具提示中显示了一个额外的空白行(在输入成员名称时出现的那一行).
我尝试了很多变体,包括但不限于以下示例中列出的变体:
public interface IFooBar {
///<summary>foo<para>bar</para><para>baz</para></summary>
void Foo();
///<summary>foo
///<para>bar</para>
///<para>baz</para>
///</summary>
void Bar();
///<summary>foo<para />bar<para />baz</summary>
void Baz();
///<summary>foo<para />
///bar
///<para />baz
///</summary>
void Qux();
}
Run Code Online (Sandbox Code Playgroud)
但它仍然出现,这是令人愤怒的.如果有人知道如何摆脱它,请帮助我.
问题不在于在XML注释中获取新行,我知道如何获取.它是关于在使用标签时删除额外的新行<para />.
可能重复:
C#中的XML多行注释 - 我做错了什么?
VB.Net和Visual Studio Intellisense中的多行XML注释
我想对我的方法有一些描述
/// <summary>
/// Perform a divide by b
/// e.g a = 1, b = 2
/// will return 0, since (1/2) = 0.5
/// </summary>
/// <returns>int value</returns>
public static int Div(int a, int b)
{
return (a / b);
}
Run Code Online (Sandbox Code Playgroud)
我希望描述以我输入的相同格式显示..但是,这些文本将始终显示在oneline上.
是否有任何标签,我可以用来让视觉工作室包括所有这些空间和新线?
谢谢