• IntelliSenseで自作クラスのメンバの説明を表示する

• この記事への評価、コメント

IntelliSenseで自作クラスのメンバの説明を表示する

Visual Studioには、クラスやメンバの情報を表示することができるIntelliSenseのクイックヒント、メンバの一覧、パラメータヒントなどの機能があります。自作のクラスやメンバでこれらのヒントを表示するには、ソースコード内にドキュメントコメントを記述します。

例えば、"TestClass"という名前のクラスに次のようなメソッドとドキュメントコメントがあるとします。

''' <summary>
''' 指定した値を合計値に加算します。
''' </summary>
''' <param name="val">加算する整数</param>
Public Shared Function Plus(ByVal val As Integer) As Integer
End Function

/// <summary>
/// 指定した値を合計値に加算します。
/// </summary>
/// <param name="val">加算する整数</param>
public static int Plus(int val)
{
}

すると、Visual Studioのエディタでクイックヒントが下図のように表示されます。

また、パラメータヒントは下図のように表示されます。

上記のコードをビルドして作成したアセンブリを使うと、ヒントが表示されません。この場合にヒントを表示するには、「ドキュメントコメントにより型の概要をXMLファイルに出力する」の方法でXMLファイルを作成し、そのファイル名をアセンブリと同じファイル名（例えば、アセンブリが「test.dll」ならば、「test.xml」）にして、アセンブリと同じフォルダに置きます。

ドキュメントコメントについてより詳しくは、「ドキュメントコメントにより型の概要をXMLファイルに出力する」をご覧ください。

• 履歴：
• 2007/2/5 .NET Framework 2.0に関する記述を追加。
• 2013/4/27 説明の大半を「ドキュメントコメントにより型の概要をXMLファイルに出力する」に移動。

（この記事は、「.NETプログラミング研究 第36号」で紹介したものです。）