改行を Intellisense ドキュメントに反映させるために、要約コメントに改行を挿入する方法を知っている人はいますか?
明確にするために、コードのドキュメントを想定しています..
/// <summary>
/// Some text documentation
/// - a line break -
/// Some more documentation
/// </summary>
public void SomeMethod() { }
したがって、このメソッドを使用すると、Intellisense は次のようにフォーマットされたメソッドの概要を提供します。
一部のテキスト ドキュメント
その他のドキュメント
(注 - 「para」タグは空の改行を作成しません - 私はそれを試しました!)
これを使ってみてください。
/// <summary>
/// <para>Paragraph 1.</para>
/// <para>Paragraph 2.</para>
/// </summary>
しかし、実際の空の行を持つことはできないと思います。空の para タグは無視されます。
これを試して：
/// <summary>
/// <para> [Non-Breaking Space] </para>
/// </summary>
[Non-Breaking Space]Alt+ 255(テンキーを使用) を使用して取得されます。
空の改行として表示されます。これは古いことは知っていますが、今日はうまくいきました。
/// <summary><br />
/// <para>To treat comment line like a DIV tag, surround them with PARA tags.</para><br />
/// <para>To add a break with whitespace, add the following line:</para><br />
/// <para> </para><br />
/// </summary>
あなたの唯一の希望は、おそらく次のようなぎこちないものです。
/// <summary>
/// <para>line one</para>
/// <para>_</para>
/// <para>line two</para>
/// </summary>
さて、Xmlです。多分