c# - C＃.NETドキュメントに改行を追加する方法

Question

これはもっと簡単なはずです...

コードの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ポップアップに改行を作成しません。

これは面倒だと思います...

助言がありますか？

Answer 1

タグを使用し<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>

Answer 2

これは私の使い方です<br/>。

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

Answer 3

<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