30

この記事によると、複数行のXMLコメントを取得することが可能です-を使用する代わりに、を///使用して/** */ください。これは、複数行のコメントとは何か、そして私が何をしたいのかについての私の解釈です。

/**
 * <summary>
 * this comment is on line 1 in the tooltip
 * this comment is on line 2 in the tooltip
 * </summary>
 */

ただし、このフォームを使用すると、コード内のクラス名にカーソルを合わせるとポップアップするツールチップが1行になります。つまり、コメントを次のように記述した場合とまったく同じように見えます。

/// <summary>
/// this comment is on line 1 in the tooltip
/// this comment is on line 2 in the tooltip
/// </summary>

この動作はVS2008でも実際に可能ですか？

編集

gabeは、「マルチライン」の意味を誤解していると指摘しました。実際に使用する<para>か<br>、意図した効果を得る必要があります。<br>改行が発生する場所を制御したいので、先に進んで使用しました。

/// <summary>
/// this comment is on line 1 in the tooltip<br/>
/// this comment is on line 2 in the tooltip<br/>
/// </summary>

コードでこのクラスのツールチップを見ると、すべてが1行で終わっています... WTH？私はここで何か間違ったことをしましたか？

アップデート

<para>さて、私は先に進んで各行のタグを試しました、そしてそれはうまくいきます。なぜそうしないのかわから<br/>ない。

/// <summary>
/// <para>this comment is on line 1 in the tooltip</para>
/// <para>this comment is on line 2 in the tooltip</para>
/// </summary>
4

3 に答える 3

20

これを試して

/// <summary>
/// this comment is on line 1 in the tooltip
/// <para>this comment is on line 2 in the tooltip</para>
/// </summary>
于 2010-03-30T17:46:50.673 に答える
17

「マルチライン」の意味について混乱しているようですね。///1行のコメントは、ソースコードの行の終わりで終了します。そのコメントを続行する場合は、次の行に「」を付ける必要があります。複数行のコメントは「」で始まり「/*」で終わる*/ため、同じ行または複数行下で終了できます。

「複数行」であることは、コメント内のテキストがどのように表示されるかについては何も言いません。XMLコメントに改行を入れるには、<br/>（ "break"）を挿入するか、<para>（ "paragraph"）タグで行を折り返す必要があります。

于 2010-03-30T17:49:28.237 に答える
2

<br/>改行を追加するか、段落をで囲み<para>...</para>ます。XMLやHTMLと同じように、改行は空白に他なりません。

于 2010-03-30T17:46:17.373 に答える