関数内の変数に<summary>コメントを付けたい

質問

こんにちは。

タイトルでは分かりにくいと思いますが、C#での話です。

例えば、以下のような関数外に変数を定義した場合、関数内の i にカーソルを合わせれば、iの近くに「これはintです。」という文字が表示がされます。

/// <summary>
/// これはintです。
/// </summary>
int i = 0;

public void GetDlgData()
{
　　　　　　MessageBox.Show(i + 1);
}

しかし、この変数をどうしても関数内に入れる必要があり、以下のようにしたところ、コメントが全く表示されなくなりました。

public void GetDlgData()
{
　　　　　　/// <summary>
　　　　　　/// これはintです。
　　　　　　/// </summary>
　　　　　　int i = 0;

　　　　　　MessageBox.Show(i + 1);
}

これでは他人のプログラムを見る自分にとっては、使いづらいの極みとなってしまうため、どうしても関数内の変数でも、<summary>コメントのような機能を持たせたいのです。

インターネットである程度探してみましたが、なかなか見つからず、必ずあるはずなので、ご存知の方がいらっしゃったら、ご教授をお願いいたします。

本当にこれで困っております。解決策をどうか教えてください。。。

以上、よろしくお願いいたします。

回答No.2

DoubtOwl · ベストアンサー

Picosoftさんが解答されているように使えません。

代案として。

・コメントを書かずとも意味が分かる変数名にする

・コメントが必要なローカル変数をプライベート変数(そのクラス内でしか使えない変数)にする。

/// <summary>
/// これはintです。
/// </summary>
private int i = 0;

public void GetDlgData()
{

　　　　　　MessageBox.Show(i + 1);
}

回答No.1

Picosoft

ドキュメントコメントが使えるのは、クラスとクラスのメンバだけです。
残念ながらローカル変数には使えません。

http://www.atmarkit.co.jp/fdotnet/teamdev/teamdev02/teamdev02_01.html