更新 : 2007 年 11 月
Visual C# では、ソース コード内で、参照先のコード ブロックの直前の特別なコメント フィールドに XML タグを配置することで、コードのドキュメントを作成できます。この例を次に示します。
/// <summary> /// This class performs an important function. /// </summary> public class MyClass{}
/doc を使用してコンパイルすると、コンパイラは、ソース コードですべての XML タグを検索し、XML ドキュメント ファイルを作成します。
XML ドキュメント コメントはメタデータでなく、コンパイルされたアセンブリに含まれないため、リフレクションでアクセスできません。
ドキュメント コメントとして推奨されるタグ
XML ファイルの処理
ドキュメント タグの区切り記号
方法 : XML ドキュメント機能を使用する (C# プログラミング ガイド)
詳細については、次のトピックを参照してください。
/doc (ドキュメント コメントの処理)
XML ドキュメントのサンプル
詳細については、「C# 言語仕様」の次のセクションを参照してください。
付録 A ドキュメント コメント