[.NET] SandCastle 用に、 namespace へのコメントをソースコードに埋め込む方法

「いや、まだだから」 より。

その３．名前空間ごとに NamespaceDoc クラスを作成する。

ということで、この方法があったりします。
つまり、名前空間のコメントを入れるためのクラスを定義してしまうってゆー、まーなんというか、盲点というか、抜け道というかｗ
C# だとこんな感じですねー。

namespace 対象とする名前空間 {
    /// <summary>
    /// 名前空間の概要
    /// </summary>
    /// <remarks>名前空間の補足</remarks>
    [System.Runtime.CompilerServices.CompilerGeneratedAttribute()]
    class NamespaceDoc {
    }
}

…ぐふぅ。 そんなぁ～!? f(^^;
はい、 まさにドキュメント読んでませんでした orz

MSDN ライブラリの CompilerGeneratedAttribute クラスの解説には、

CompilerGeneratedAttribute 属性を使用して、要素がコンパイラによって追加されたか、ソース コード内で直接作成されたかを判断します。

この属性によって、SQL サーバーはコンパイラが生成した静的な値を参照できるようになります。

…って、 意味不明のことしか書いてないし～ (;;

ともあれ、 これで楽になるぞ (^^;

ただ、 このやり方だと、 不要なクラスがバイナリに入っちゃうのがちょっちいやんな感じ。
出来あがったアセンブリを ILDASM で覗くと、 こんなふう。

static クラスに変えたのでコンストラクタは無くなってますけど、 当然ながらクラス定義はしっかりアセンブリに入っちゃってます。