.NET TIPS

ブロック・コメント記述時に余計なアスタリスクを挿入しないようにするには？［C#、VS 2005、VS 2008］

デジタルアドバンテージ　遠藤 孝信
2009/10/01

　C#では、コード内におけるコメントの記述方法として、以下の2つがある（カッコ内は具体的な記述方法）。

  • 単一行コメント（// ……コメント……）
  • 区切り記号付きコメント（/* ……コメント…… */）

　このうち後者は一般に「ブロック・コメント」とも呼ばれ、連続する複数の行をコメントアウトしたい場合に利用できる。

Visual Studioでのブロック・コメントの記述

　しかしVisual Studio 2005や2008でブロック・コメントを記述しようとすると、以下の画面に示すように、余計なアスタリスク「*」が自動的に挿入されてしまう。以下の画面は、Form1_Loadメソッドの4行をブロック・コメントによりコメントアウトしようとしているところである。



「/*」を入力



カーソルを「}」の直後に移動



改行（［Enter］キーを入力）
改行時に自動挿入される余計な「 * 」
ここではForm1_Loadメソッド全体をブロック・コメント（/* 〜 */）により、コメントアウトしようとしているが、「*/」を記述するために改行を行うと、自動的に「 * 」が挿入されてしまう。

　これはつまり、「/*」を記述した行以降で改行を行った場合、自動的に「 * 」が挿入されるということだ。

　本来この機能は、以下のような形式のXMLドキュメント・コメントを容易に記述するためのものである。このようなブロック・コメントによるXMLドキュメント・コメントの記述についての詳細は、MSDNの「C# プログラミング ガイド：ドキュメント タグの区切り記号」を参照してほしい。

/**
 * <summary>
 * Loadイベント・ハンドラ
 * </summary> */
private void Form1_Load(object sender, EventArgs e)
{

}
ブロック・コメントによるXMLドキュメント・コメントの記述例
C#では、「/// 〜」以外に「/** 〜 */」によってもXMLドキュメント・コメントが記述可能だ。

機能の無効化

　ブロック・コメント記述時にアスタリスクが自動挿入される機能を無効にするには、まずメニューの［ツール］−［オプション］により［オプション］ダイアログを開き、ダイアログ左側のツリーで、［テキスト エディタ］−［C#］−［詳細］を選択する。

　そして、「/// に対するXML ドキュメントを生成する」の項目のチェックをオフにする（デフォルトはオン）。


［オプション］ダイアログ
余計なアスタリスクを挿入させないようにするには、左側のツリーで、［テキスト エディタ］−［C#］−［詳細］を選択し、「/// に対するXML ドキュメントを生成する」の項目のチェックをオフにする。

　しかし当然ながら、この項目をオフにすると、「///」を入力したときにXMLドキュメント・コメントが自動生成されなくなるので注意してほしい。End of Article

カテゴリ：Visual Studio 2005　処理対象：IDE
カテゴリ：Visual Studio 2008　処理対象：IDE

この記事と関連性の高い別の.NET TIPS
［ASP.NET］DataGridコントロールに選択ボタンを追加するには？
このリストは、（株）デジタルアドバンテージが開発した
自動関連記事探索システム Jigsaw（ジグソー） により自動抽出したものです。
generated by

「.NET TIPS」

TechTargetジャパン

Insider.NET フォーラム 新着記事

＠ITメールマガジン　新着情報やスタッフのコラムがメールで届きます（無料）

RSSフィード

＠IT 新着記事

キャリアアップ

- PR -
＠IT Sepcial
→ ＠IT Special ヘ

イベントカレンダー

PickUpイベント

- PR -
もっと見る
- PR -

お勧め求人情報

ホワイトペーパー（TechTargetジャパン）

＠IT Sepcial
→ ＠IT Special ヘ
ソリューションFLASH