チュートリアル: .NET コンソール アプリケーションをデバッグする

このチュートリアルでは、Visual Studioで使用できるデバッグ ツールについて説明します。

このチュートリアルでは、.NET アプリを操作するためにVisual Studio Codeで使用できるデバッグ ツールについて説明します。

このチュートリアルでは、.NET アプリを操作するために GitHub Codespaces で使用できるデバッグ ツールについて説明します。

デバッグ ビルド構成を使用する

Debug と Release はVisual Studioの組み込みビルド構成です。 デバッグにはデバッグ ビルド構成を使用し、最終リリース配布にはリリース構成を使用します。

デバッグ構成では、プログラムは完全なシンボリック デバッグ情報を使用してコンパイルされ、最適化は行われません。 ソース コードと生成された命令の関係がより複雑になるため、最適化によってデバッグが複雑になります。 プログラムのリリース構成にはシンボリック デバッグ情報がなく、完全に最適化されています。

既定では、Visual Studioはデバッグ ビルド構成を使用するため、デバッグ前に変更する必要はありません。

1. Visual Studioを開始します。

2. 作成したプロジェクトを開きます.NETコンソールアプリケーションを作成する。

   現在のビルド構成がツール バーに表示されます。 次のツール バーの図は、アプリのデバッグ バージョンをコンパイルするようにVisual Studioが構成されていることを示しています。

   

1. その行のコード ウィンドウの左余白をクリックして、名前、日付、時刻を表示する行に ブレークポイント を設定します。 左余白は行番号の左側にあります。 ブレークポイントを設定するその他の方法としては、コード行にカーソルを置き、F9 押すか、メニュー バーから [デバッグ][ブレークポイントの切り替え] 選択します。

   次の図に示すように、Visual Studioはブレークポイントを強調表示し、左余白に赤い点を表示することで、ブレークポイントが設定されている行を示しています。

   

2. F5 押して、プログラムをデバッグ モードで実行します。 デバッグを開始するもう 1 つの方法は、メニューから [デバッグ][デバッグの開始] 選択することです。

3. プログラムで名前の入力を求められたら、コンソール ウィンドウに文字列を入力し、Enterキー 押します。

4. ブレークポイントに達すると、Console.WriteLine メソッドが実行される前に、プログラムの実行が停止します。 ローカル ウィンドウには、現在実行中のメソッドで定義されている変数の値が表示されます。

   Visual Studio のブレークポイントのスクリーンショット

1. Visual Studio Codeを開始します。

2. .NETコンソール アプリケーションを作成します。

3. Program.cs ファイルを開きます。

4. コード ウィンドウの左余白をクリックして、名前、日付、時刻を表示する行に ブレークポイント を設定します。 左余白は行番号の左側にあります。 ブレークポイントを設定するその他の方法は、 F9 キーを押すか、コード行が選択されている間にメニューから [実行>ブレークポイント を取得する] を選択することです。

   Visual Studio Codeは、左余白に赤い点を表示して、ブレークポイントが設定されている行を示します。

   

1. .NET コンソール アプリケーションを作成で作成したGitHub Codespace を開きます。

2. HelloWorld.cs ファイルを開きます。

3. コード ウィンドウの左余白をクリックして、名前、日付、時刻を表示する行に ブレークポイント を設定します。 左余白は行番号の左側にあります。 コード行が選択されている間に F9 キーを押してブレークポイントを設定することもできます。

   

前のセクションで説明したように、ブレークポイントに達するとプログラムの実行が停止します。 ローカル ウィンドウには、現在実行中のメソッドで定義されている変数の値が表示されます。

Debug と Release は.NETの組み込みビルド構成です。 デバッグにはデバッグ ビルド構成を使用し、最終リリース配布にはリリース構成を使用します。

既定では、Visual Studio Code起動設定ではデバッグ ビルド構成が使用されるため、デバッグ前に変更する必要はありません。

1. 左側のメニューの [デバッグ] アイコンを選択して、[デバッグ] ビューを開きます。

   

2. [ 実行とデバッグ] を選択します。 メッセージが表示されたら、 C# を選択し、[ C#: スタートアップ プロジェクトを起動する] を選択します。 デバッグ モードでプログラムを起動するその他の方法は、 F5 キーを押すか、メニューから [実行>デバッグの開始 ] を選択することです。

   

3. [起動構成の選択] を求められたら、[C#: アクティブ ファイルのデバッグ] を選択します。

4. [デバッグ コンソール] タブを選択すると、応答を待つ前にプログラムに表示される "名前は何ですか?" というプロンプトが表示されます。

   

5. 名前のプロンプトに応答して「デバッグ コンソール」ウィンドウに文字列を入力し、「Enterキー」を押します。

   ブレークポイントに達すると、 Console.WriteLine メソッドが実行される前に、プログラムの実行が停止します。 [変数] ウィンドウの [ローカル] セクションには、現在実行中のメソッドで定義されている変数の値が表示されます。

   

既定では、GitHub Codespaces はデバッグ ビルド構成を使用するため、デバッグ前に変更する必要はありません。

1. 左側のメニューの [デバッグ] アイコンを選択して、[デバッグ] ビューを開きます。

   

2. [ 実行とデバッグ] を選択します。 メッセージが表示されたら、デバッガーとして [C# ] を選択し、[ C#: アクティブ ファイル を起動構成としてデバッグ] を選択します。

3. [デバッグ コンソール] タブを選択すると、応答を待つ前にプログラムに表示される "名前は何ですか?" というプロンプトが表示されます。

4. 名前のプロンプトに応答して「デバッグ コンソール」ウィンドウに文字列を入力し、「Enterキー」を押します。

   ブレークポイントに達すると、 Console.WriteLine メソッドが実行される前に、プログラムの実行が停止します。 [変数] ウィンドウの [ローカル] セクションには、現在実行中のメソッドで定義されている変数の値が表示されます。

   

イミディエイト ウィンドウを使用する

イミディエイト ウィンドウを使用すると、デバッグしているアプリケーションを操作できます。 変数の値を対話形式で変更して、プログラムに与える影響を確認できます。

1. Immediate ウィンドウが表示されない場合は、Debug>Windows>Immediate を選択して表示します。

2. Immediate ウィンドウに name = "Gracie" を入力し、Enter キーを押します。

3. Immediate ウィンドウに currentDate = DateTime.Parse("2026-02-05T20:25:00Z").ToUniversalTime() を入力し、Enter キーを押します。

   イミディエイト ウィンドウには、文字列変数の値と DateTime 値のプロパティが表示されます。 さらに、変数の値は、ローカル ウィンドウで更新されます。

   

4. F5 押してプログラムの実行を続行します。 続行するもう 1 つの方法は、メニューから [デバッグ][続行] 選択することです。

   コンソール ウィンドウに表示される値は、イミディエイト ウィンドウで行った変更に対応します。

5. 任意のキーを押してアプリケーションを終了し、デバッグを停止します。

デバッグ コンソールを使用する

デバッグ コンソール ウィンドウを使用すると、デバッグしているアプリケーションと対話できます。 変数の値を変更して、プログラムに与える影響を確認できます。

1. [ デバッグ コンソール ] タブを選択します。

2. name = "Gracie"] ウィンドウの下部にあるプロンプトに「」と入力し、Enter キーを押します。

   

3. currentDate = DateTime.Parse("2026-01-28T20:54:00Z").ToUniversalTime()] ウィンドウの下部に「」と入力し、Enter キーを押します。

   [ 変数] ウィンドウには、 name 変数と currentDate 変数の新しい値が表示されます。

4. ツール バーの [続行] ボタンを選択して、プログラムの実行を 続行 します。 続行するもう 1 つの方法は、 F5 キーを押すことです。

   

   コンソール ウィンドウに表示される値は、 デバッグ コンソールで行った変更に対応します。

   

5. Enter キーを押してアプリケーションを終了し、デバッグを停止します。

1. ブレークポイントを表す赤い点を右クリックします。 コンテキスト メニューで、[条件] を選択して、[ブレークポイント設定の ] ダイアログを開きます。 まだ選択されていない場合は、条件 のボックスを選択します。

   ブレークポイント設定パネルを示す

2. 条件式の場合は、テキスト フィールドに次のコードを入力します。

   string.IsNullOrEmpty(name)
   

   String.IsNullOrEmpty(name)
   

   ブレークポイントにヒットするたびに、デバッガーは String.IsNullOrWhiteSpace(name) メソッドを呼び出し、メソッド呼び出しが trueを返す場合にのみ、この行で中断します。

   条件式の代わりに、ヒット カウントを指定できます。この場合、ステートメントを指定した回数だけ実行する前にプログラムの実行が中断されます。 もう 1 つのオプションは、フィルター条件を指定することです。これにより、スレッド識別子、プロセス名、またはスレッド名などの属性に基づいてプログラムの実行が中断されます。

3. 閉じる を選択して、ダイアログ ボックスを閉じます。

4. F5キー 押して、デバッグでプログラムを開始します。

5. コンソール ウィンドウで、名前の入力を求められたら、Enter キーを押します。

6. 指定した条件 (name が null または String.Emptyのいずれか) を満たしているため、ブレークポイントに達すると、Console.WriteLine メソッドが実行される前にプログラムの実行が停止します。

7. ローカル ウィンドウを選択すると、現在実行中のメソッドに対してローカルな変数の値が表示されます。 この場合、Main は現在実行中のメソッドです。 name 変数の値が ""、または String.Emptyされていることを確認します。

8. イミディエイト ウィンドウに次のステートメントを入力し、Enterキー 押して、値が空の文字列であることを確認します。 結果は trueです。

   ? name == String.Empty
   

   ? String.IsNullOrEmpty(name)
   

   疑問符は、イミディエイト ウィンドウに、式を評価するように指示します。

   

9. F5 押してプログラムの実行を続行します。

10. 任意のキーを押してコンソール ウィンドウを閉じ、デバッグを停止します。

11. コード ウィンドウの左余白にあるドットをクリックして、ブレークポイントをクリアします。 ブレークポイントをクリアするその他の方法は、F9 押すか、コード行の選択中に [デバッグ] [ブレークポイントの切り替え] 選択することです。

1. ブレークポイントを表す赤い点を右クリック (macOS では Ctrl キーを押しながらクリック) します。 コンテキスト メニューで [ブレークポイントの 編集] を選択して、条件式を入力できるダイアログを開きます。

   

2. ドロップダウンで Expression を選択し、次の条件式を入力して Enter キーを押 します。

   String.IsNullOrEmpty(name)
   

   

   ブレークポイントにヒットするたびに、デバッガーは String.IsNullOrEmpty(name) メソッドを呼び出し、メソッド呼び出しが trueを返す場合にのみ、この行で中断します。

   条件式の代わりに、ヒットカウントを指定できます。この ヒットカウントは、ステートメントが指定された回数実行される前にプログラムの実行を中断します。 もう 1 つのオプションは、フィルター条件を指定することです。これにより、スレッド識別子、プロセス名、またはスレッド名などの属性に基づいてプログラムの実行が中断されます。

3. F5キー 押して、デバッグでプログラムを開始します。

4. [デバッグ コンソール] タブで、名前の入力を求められたら Enter キーを押します。

   指定した条件 (name が null または String.Emptyのいずれか) を満たしているため、プログラムの実行はブレークポイントに達すると、 Console.WriteLine メソッドが実行される前に停止します。

   [ 変数] ウィンドウには、 name 変数の値が ""( String.Empty)であることが表示されます。

5. デバッグ コンソールのプロンプトで次のステートメントを入力し、Enter キーを押して、値が空の文字列であることを確認します。 結果は trueです。

   name == String.Empty
   

6. ツール バーの [ 続行 ] ボタンを選択して、プログラムの実行を続行します。

7. Enter キーを押してプログラムを終了し、デバッグを停止します。

8. コード ウィンドウの左余白にあるドットをクリックして、ブレークポイントをクリアします。 ブレークポイントをクリアするその他の方法は、 F9 キーを押すか、コード行が選択されている間にメニューから [ブレークポイントの実行] > [ブレークポイントの切り替え ] を選択することです。

9. ブレークポイントの条件が失われるという警告が表示された場合は、[ ブレークポイントの削除] を選択します。

Visual Studioでは、プログラムを 1 行ずつステップ 実行し、その実行を監視することもできます。 通常は、ブレークポイントを設定し、プログラム コードのごく一部を通してプログラム フローに従います。 このプログラムは小さいので、プログラム全体をステップ実行できます。

1. 「What is your name?」というプロンプトを表示する行のコードにブレークポイントを設定します。

2. [デバッグ]>[ステップ イン] の順に選択します。 一度に 1 つのステートメントをデバッグするもう 1 つの方法は、F11押すことです。

   Visual Studio が強調表示するとともに、次に実行される行の横に矢印を表示します。

   

   この時点で、ローカル ウィンドウには、args 配列が空で、name と currentDate に既定値が表示されます。 さらに、Visual Studioは空白のコンソール ウィンドウを開いています。

3. F11 キーを押します。 Visual Studioは、name 変数の代入を含むステートメントを強調表示します。 [ローカル] ウィンドウに name が null であると表示され、コンソール ウィンドウに "What is your name?" という文字列が表示されます。

4. コンソール ウィンドウに文字列を入力し、Enterキー 押して、プロンプトに応答します。 コンソールが応答せず、入力した文字列はコンソール ウィンドウに表示されませんが、Console.ReadLine メソッドは入力をキャプチャします。

5. F11 キーを押します。 Visual Studioは、currentDate 変数の代入を含むステートメントを強調表示します。 ローカル ウィンドウには、Console.ReadLine メソッドの呼び出しによって返される値が表示されます。 コンソール ウィンドウには、プロンプトで入力した文字列も表示されます。

6. F11 キーを押します。 ローカル ウィンドウには、currentDate プロパティからの割り当ての後に DateTime.Now 変数の値が表示されます。 コンソール ウィンドウは変更されません。

7. F11 キーを押します。 Visual Studioは、Console.WriteLine(String, Object, Object) メソッドを呼び出します。 コンソール ウィンドウに、書式設定された文字列が表示されます。

8. デバッグ>ステップアウトを選択します。ステップバイステップの実行を停止するもう1つの方法は、Shift+F11を押すことです。

   コンソール ウィンドウにメッセージが表示され、キーを押すのを待ちます。

9. 任意のキーを押してコンソール ウィンドウを閉じ、デバッグを停止します。

Visual Studio Codeでは、プログラムを 1 行ずつステップ 実行し、その実行を監視することもできます。 通常は、ブレークポイントを設定し、プログラム コードのごく一部を通してプログラム フローに従います。 このプログラムは小さいので、プログラム全体をステップ実行できます。

1. 「What is your name?」というプロンプトを表示する行のコードにブレークポイントを設定します。

2. F5 キーを押してデバッグを開始します。

   Visual Studio Codeではブレークポイント行が強調表示されます。

   この時点で、[ 変数] ウィンドウには、 args 配列が空であり、 name と currentDate に既定値が表示されます。

3. [デバッグ] ツール バーから [ステップ イン ] を選択するか 、F11 キーを押します。

   

   Visual Studio Code次の行が強調表示されます。

4. Visual Studio Code名前プロンプトのConsole.WriteLineを実行し、次の実行行を強調表示します。 次の行は、Console.ReadLineのためのnameです。 [変数] ウィンドウは変更されず、[ターミナル] タブに "名前は何ですか?" というプロンプトが表示されます。

5. [ ステップ イン] を選択するか 、F11 キーを押します。

   Visual Studio Codeは、name 変数の代入を強調表示します。 変数ウィンドウは、name がまだ nullであることを示しています。

6. ターミナル タブに文字列を入力し、Enter キーを押して、プロンプトに応答 します。

   [ デバッグ コンソール ] タブには、入力中に入力した文字列が表示されない場合がありますが、 Console.ReadLine メソッドによって入力がキャプチャされます。

7. [ ステップ イン] を選択するか 、F11 キーを押します。

   Visual Studio Codeは、currentDate 変数の代入を強調表示します。 [ 変数] ウィンドウには、 Console.ReadLine メソッドの呼び出しによって返される値が表示されます。 [ ターミナル ] タブには、プロンプトで入力した文字列が表示されます。

8. [ ステップ イン] を選択するか 、F11 キーを押します。

   [変数] ウィンドウには、currentDate プロパティからの代入後のDateTime.Now変数の値が表示されます。

9. [ ステップ イン] を選択するか 、F11 キーを押します。

   Visual Studio Codeは、Console.WriteLine(String, Object, Object) メソッドを呼び出します。 コンソール ウィンドウに、書式設定された文字列が表示されます。

10. [ステップ アウト] を選択するか、Shift キー+F11 キーを押します。

    

    ターミナルに「任意のキーを押して終了...」と表示されます。

11. 任意のキーを押してプログラムを終了します。

コンソール アプリケーションのリリース バージョンをビルドしてテストするには、ツール バーのビルド構成を Debug から Releaseに変更します。

F5を押すか、Build メニューから Build Solution を選択すると、Visual Studio がアプリケーションのリリース バージョンをコンパイルします。 デバッグ バージョンの場合と同様にテストできます。

コンソール アプリケーションのリリース バージョンをビルドしてテストするには、 ターミナル を開き、次のコマンドを実行します。

dotnet run --configuration Release

コンソール アプリケーションのリリース バージョンをビルドしてテストするには、ターミナルで次のコマンドを実行します。

dotnet run --configuration Release HelloWorld.cs