読者です 読者をやめる 読者になる 読者になる

プログラマーな日々

プログラマーをやっています。好きなツール:WorkFlowy、好きな言語:C#、好きなサービス:Backlog、好きなAWS:AWS Lambda。

XML形式のドキュメントコメントにジェネリック型へのリンクを設定する(その2)

以前実体参照を使ってXMLコメントに"<"や">"を含める方法を紹介しました。
XML形式のドキュメントコメントにジェネリック型へのリンクを設定する - プログラマーな日々

今回はCDATAを使う方法を紹介します。こちらの方が楽で可読性も高いです。

ジェネリック型へのリンク

こんな具合です。

<![CDATA[
<see cref="System.Collections.Generic.List<T>"/>
]]>

サンプルコードも

<example>
<code>
int i = 1;
if (i < hoge) {
    Console.Write("iはhogeより小さい");
}
</code>
</example>

不等号はCDATAで記述します。

<![CDATA[
<example>
<code>
int i = 1;
if (i < hoge) {
    Console.Write("iはhogeより小さい");
}
</code>
</example>
]]>