如何在C#.NET文档中添加换行符

如何在C#.NET文档中添加换行符,c#,.net,xml-documentation,C#,.net,Xml Documentation,这应该更容易些 我想在代码中的XML文档中添加一个“编码的”换行符 /// <summary> /// Get a human-readable variant of the SQL WHERE statement of the search element. &lt;br/&gt; /// Rather than return SQL, this method returns a string with icon-tokens, which /// could b

这应该更容易些

我想在代码中的XML文档中添加一个“编码的”换行符

/// <summary>
/// Get a human-readable variant of the SQL WHERE statement of the search element. &lt;br/&gt;
/// Rather than return SQL, this method returns a string with icon-tokens, which 
/// could be used to represent the search in a condensed pictogram format.
/// </summary>
//
///获取搜索元素的SQL WHERE语句的可读变体。溴/
///此方法不返回SQL,而是返回一个带有图标标记的字符串,该字符串
///可用于以浓缩的象形图格式表示搜索。
/// 
如您所见,我找到了一些答案,演示了如何添加<和>括号。 有趣的是,好的'ol
换行符不会在Intellisense弹出窗口中创建换行符

我觉得这很烦人

有什么建议?

< p>可以使用<代码> <代码>标签来生成段落中断,或者可以将代码包在<代码> <代码>标签中作为分组的方法,并在其之后添加空行,但没有等同于<代码>
<代码>或诸如此类的东西。(根据旧的微软论坛帖子,这是设计的。)你可以从微软那里获得这篇文档文章中可用标签的列表

示例(基于原始OP样本):

//
///获取搜索元素的SQL WHERE语句的可读变体。
///此方法不返回SQL,而是返回一个带有图标标记的字符串,该字符串
///可用于以浓缩的象形图格式表示搜索。
/// 
添加一个
标记,其中包含一个特殊字符,即255字符或

//
///一些文本
///    
///更多文本
/// 
///一些绳子
公共方法(字符串str){}
它的工作原理如下:






似乎不起作用,有时,这并不是真正让
句子分开,而是希望有一个空白行来分隔关注点。我在这里提到这一点是因为这个问题似乎是许多这种性质的封闭性问题的根源

我唯一能找到工作的就是

<para>&#160;</para>

这是我的用法,就像

,它正在工作:)

//
///值:0/1/2
///0福,
///1巴,
///2其他
/// 

自Visual Studio 2019起,在注释中使用新行

例如:

//
///这是一条评论。
///这是另一条评论
///这是一条很长的评论,所以我希望它在另一行继续
。 ///



请注意,当我们使用

而不是
时,没有添加额外的行!现在我们在做饭!谢谢这已经困扰我很长时间了。。。我看到上面列出了para选项,但我认为这是一个“paramater”快捷方式。对我来说不起作用。在VS 2010上使用VB.NET,尝试使用Powertools的彩色参数选项和不使用Powertools的彩色参数选项,
标记被忽略,所有内容都在Intellisense中混合到一行中。找到了这个问题,Hans在其中解释了问题:。请确保您也添加了结束标记=)这个问题的缺点是它实际上添加了一整行空行,而不仅仅是新行。那么有人找到了实际插入一行而不是两行的方法吗?这很有帮助,但是
不起作用,使用
// 
我个人把
//
放在一张便签里。那就是复制粘贴了!(而且它可以工作——至少对我来说)我不知道为什么,但是复制粘贴根本不起作用<代码>// 工作!不要在文本块之间使用
标记,而应该在
元素中除第一段以外的所有段落周围使用
标记。对于
元素,如果有多个段落,请在所有段落周围使用它们(如果这些元素只有一个段落,则可选)。对于所有其他块元素(包括另一个块元素内部的
),在所有段落周围使用
标记,即使您只有一个。来源:我撰写了这篇文章,包括大多数演示样式:为什么这个答案被否决?它是有效的,并且似乎是比使用
和#160更好的解决方案
或不可见字符…在最新版本的VS
中,似乎添加了一个空行,而不仅仅是换行符。@IlPADlI,+1作为用法示例。确认正在进行VS 2012终极更新5.VS 2017:添加了空行,而不仅仅是换行…microsoft当然喜欢告诉我们我们想要做什么…@assimilator:欢迎您编写自己的操作系统,IDE和所有其他你不满意的微软工具。仍然很有用,因为这个问题是谷歌关于如何在C#文档中添加换行符的最佳结果。这个答案需要更高,或者被认为是正确答案,它隐藏在2个答案下面,告诉您使用
。如果它在Visual Studio代码和Visual Studio 2019中都有效,我将对此进行升级。也许我错过了一个设置,但是
在VSC中对我没有任何帮助。谢谢你的VS提示!从Visual studio 2019开始,可以使用
创建换行符。参考答案。
/// <summary>
/// Some text
/// <para>   </para>
/// More text
/// </summary>
/// <param name="str">Some string</param>
public void SomeMethod(string str) { }
<para>&#160;</para>
/// <summary>
///     <para>
///         "This sentence shows up when the type is hovered"
///     </para>
///     <para>&#160;</para>
///     <para>int PrimaryKey</para>
///     <para>&#160;</para>
///     <para>virtual Relation Relation</para>
/// </summary>
"This sentence shows up when the type is hovered"

int PrimaryKey

virtual Relation Relation
/// <summary>
/// Value: 0/1/2
/// <para/>0 foo,
/// <para/>1 bar,
/// <para/>2 other
/// </summary>