« .NET Tips: VC++ から来た人向け | メイン | .NET Tips: 名前付けのガイドライン »

.NET Tips: C#で XML コメントからヘルプを作成

tips.gif
■ Visual Studio の HTML ヘルプ作成機能

C# では XML コメントを書くことで、HTML ヘルプをコードから自動生成することが出来る。
※ 尚、VB.NET では次期バージョン (2005) から、この機能に対応する。

Visual Studio では、メニューから「Web ページのビルド コメント」を選ぶことで、コードの XML コメントからHTML ヘルプ作られる。

但し、この機能で作られた HTML ヘルプは、Windows XP SP2では見ることができない。

参考:


■ NDoc の紹介

"NDoc" というツールを使うことで、MSDN のような HTMLヘルプ形式 (.chm ファイル) を含む様々なヘルプ形式を出力できる。
※ プロジェクトのプロパティで「XML ドキュメント ファイル」を指定しておく必要がある。

NDoc の使い方はこちらを参考に。

コメント (2)

私のお気に入りは、NAntのndocタスクをちょっぴりいじって、こいつでHTMLヘルプ出力してやる方法です。

http://tsune.japan.webmatrixhosting.net/NWiki.aspx?page=NAnt0.84#heading:4

中西 さん、こんにちは。

NAnt に関するすばらしい資料ですね。なんて詳細な。
ありがとうございます。

コメントを投稿

(いままで、ここでコメントしたことがないときは、コメントを表示する前にこのブログのオーナーの承認が必要になることがあります。承認されるまではコメントは表示されません。そのときはしばらく待ってください。)

About

2005年03月09日 09:24に投稿されたエントリーのページです。

ひとつ前の投稿は「.NET Tips: VC++ から来た人向け」です。

次の投稿は「.NET Tips: 名前付けのガイドライン」です。

他にも多くのエントリーがあります。メインページアーカイブページも見てください。

Powered by
Movable Type 3.35