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

这应该更容易...

我想在代码中的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>

如您所见，我发现了一些答案，这些答案说明了添加<和>方括号。有趣的是，好的'ol <br />换行符不会在Intellisense弹出窗口中创建换行符。

我觉得这很烦人...

有什么建议？

您可以使用<para />标记来产生段落分隔符，也可以将文本包装在<para></para>标记中，以将文本分组并在其后添加空白行，但是没有等效项<br />或类似的东西。（根据这个旧的MS论坛帖子，这是设计使然。）您可以从MS获得此文档文章中的可用标签列表。记录代码

示例（基于原始OP示例）：

/// <summary>
/// <para>Get a human-readable variant of the SQL WHERE statement of the search element.</para>
/// 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>

这是我的用法，就像<br/>，它正在工作:)

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

从Visual Studio 2019开始，<br/>在注释中使用换行符。

例：

/// <summary>
/// This is a comment.<br/>
/// This is another comment <br/>
/// This is a long comment so i want it to continue <br/> on another line.
/// </summary>

请注意，当我们使用<br/>而不是时，没有添加任何额外的行<para>。

添加一个<para>带有特殊字符，255 char或invisible char的标签。

/// <summary>
/// Some text
/// <para>   </para>
/// More text
/// </summary>
/// <param name="str">Some string</param>
public void SomeMethod(string str) { }

它将像这样工作：

<br></br>并<br />没有看起来的工作，有时它是不是真正的使<para>句子分开尽可能有关注分离一个空行的愿望。我在这里提到这一点是因为这个问题似乎是许多这种性质的封闭问题的根源。

我发现唯一起作用的是

<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