misc.log

日常茶飯事とお仕事と

ドキュメントコメント中の「<」や「>」

Visual Studio 2005以降に標準搭載されている機能に、ドキュメントコメントがあります。で、これを使ってヘルプファイルにすることをもくろんだコメントを書いていくと、サンプルコードや参照設定に、「<」や「>」が登場することってあると思います。しかし、これをそのまま書いてしまうとドキュメントコメントのタグと混同したコンパイラがエラーを出し、本題ではないコメントの書式でビルドが通らないという事態に。これを回避するには、上記の文字を以下のように置換してください。

・「<」→「&lt;」
・「>」→「&gt;」


それぞれ、「less than」「greater than」の略です。

参考情報

d.hatena.ne.jp