例えば
Foo.cs:
using System;
/// <summary>
/// This file contains Foo and Bar-related things.
/// </summary>
namespace Xyz {
class FooThing {
}
}
C# はそのような XMLDoc コメントをサポートしていますか?
例えば
Foo.cs:
using System;
/// <summary>
/// This file contains Foo and Bar-related things.
/// </summary>
namespace Xyz {
class FooThing {
}
}
C# はそのような XMLDoc コメントをサポートしていますか?
いいえ、この記事で説明されているように、XMLドキュメントのコメントは特定のタイプの要素にのみ表示できます。
ソースコードファイルでは、以下の前にあるドキュメントコメントを処理してXMLファイルに追加できます。
クラス、デリゲート、インターフェースなどのユーザー定義型
フィールド、イベント、プロパティ、メソッドなどのメンバー
ファイルレベルのXMLDocスタイルのコメントをファイルに配置すると、次のクラスまたは表示される他の要素に追加されます。Sandcastleなどの特定のドキュメントツールは、名前空間レベルのXMLDocコメントを追加する方法を提供しますが、通常、それらは別のファイルに表示されます。
もちろん、標準の/ * * /スタイルのコメントブロックを使用するだけで、各ファイルで非XMLDocスタイルのコメント(著作権ヘッダーなど)を使用できます。
/doc documentationによると、いいえ、それはサポートされていません。
ソース コード ファイルでは、次の前にあるドキュメント コメントを処理して XML ファイルに追加できます。
クラス、デリゲート、インターフェイスなどのユーザー定義型
フィールド、イベント、プロパティ、メソッドなどのメンバー