Architect's Log

I'm a Cloud Architect. I'm highly motivated to reduce toils with driving DevOps.

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>
]]>