Top > Programmingとか > VB / VB.NET > VB2005Expressβ

(3) XMLドキュメントコメント

「 '''<summary>~</summary>」で入れたXMLドキュメントコメントを折りたたむと、タグの中の本文が連結されて表示されます。

たとえば、

''' <summary>
''' abc
''' def
''' </summary><

とかやると、折りたたんだ時には

[abc def]

って感じで。

C#2005β2で同様に折りたたむと、コメントの1行目(つまり[///<summary> ...]って感じ)が表示され、何をコメントしているかわかりません。

勝った。

いゃいゃ勝ち負けじゃないから。
つかβ取れるまでにC#もたぶん直っているんじゃないかなーと推測してみたり。
なんぼなんでも[///<summary> ...]じゃ表示の意味がないんではないかと。
…あるのか?

なにがなんでもコメント領域の1行目、って動作は、VB.NET2003でのがやはりそんな感じで。
コメント領域の上下を「*******」でくくる癖のある私は、しかたがないので

'*** コメントでーす ***************
' コメントでーす
'********************************

なんてやってお茶を濁していたんですが。
今回はすっきり書けるよぅになってうれしー   あ。

「'」で書いたコメント群を折りたたむと、[...]と表示されてしまぅ。

もぅ折りたたみたくなるよぅなコメントはすべて「'''」で書けってことなんでしょうか。
あとでドキュメント生成に流用したいので、ドキュメント用コメントは「'''」、コード内コメントは「'」で使い分けよぅと思っていたもくろみが一気にアウト。

ここはなんとかしてほしいなー。
でも両方とも内容が出てきちゃうと、折りたたんでいる時にただのコメントなのかXMLドキュメントコメントかの見分けがつかないしなー。
色を変えるとかなんとかそのへんの対応でどぅにかならないもんなんかしら。

トラックバック

このエントリーのトラックバックURL:
http://salv.miscnotes.com/mt/mt-tb.cgi/204

コメントを投稿