C# デバッグ構成のプロジェクト設定 (.NET Core、.NET 5 以降、ASP.NET Core)
C# プロジェクトのデバッグ設定は、プロジェクト のプロパティ ページの [デバッグ] タブ および [ビルド] タブ 変更できます。
プロパティ ページを開くには、ソリューション エクスプローラー でプロジェクト 選択し、プロパティ アイコンを選択するか、プロジェクトを右クリックして [プロパティ] 選択します。
詳細については、「デバッグ構成とリリース構成を参照してください。
重要
これらの設定は、.NET Framework または UWP アプリには適用されません。 .NET Framework のデバッグ設定を構成するには、「C# デバッグ構成のプロジェクト設定を参照してください。
[デバッグ] タブ
Visual Studio 2022 以降では、[デバッグ] タブで [デバッグ起動プロファイルを開く] UI 選択して起動プロファイル UI を開き、デバッグ設定を変更します。
起動プロファイル (.NET Core、.NET 5 以降)
| 設定 | 説明 |
|---|---|
| コマンドライン引数 | デバッグするアプリのコマンド ライン引数を指定します。 コマンド名は、「外部プログラムの開始 で指定されたアプリ名です。 |
| 作業ディレクトリ | デバッグするアプリの作業ディレクトリを指定します。 C# では、作業ディレクトリは既定で \bin\debug されます。 |
| リモート コンピューター を使用する | リモート デバッグの場合は、このオプションを選択し、リモート デバッグ ターゲットの名前を入力するか、msvsmon サーバー名 を入力します。 リモート コンピューター上のアプリの場所は、[ビルド] タブの [出力パス] プロパティで指定します。この場所は、リモート コンピューター上の共有可能なディレクトリである必要があります。 |
| 環境変数 | アプリケーション プロセスを実行する前に環境変数を設定します。 ASP.NET Core については、「環境」「」を参照してください。 |
| アンマネージド コードデバッグ を有効にする | マネージド アプリからネイティブ (アンマネージド) Win32 コードへの呼び出しをデバッグします。 |
| SQL Server デバッグ を有効にする | SQL Server データベース オブジェクトをデバッグします。 |
| WebView2 デバッグ を有効にする | Microsoft Edge (Chromium) ベースのデバッガーを使用して JavaScript をデバッグします。 |
起動プロファイル (ASP.NET Core)
.NET 5 以降のプロパティに加えて、ASP.NET Core 起動プロファイルには、さまざまな ASP.NET Core プロファイルの追加プロパティがいくつか含まれています。 これらの設定により、プロジェクトの launchSettings.json ファイルに簡単な UI が提供されます。 このファイルの詳細については、「ASP.NET Coreで複数の環境を使用する」の「開発と launchSettings.json」セクションを参照してください。
起動プロファイル UI で提供される設定には、次のものがあります。
| 設定 | 説明 |
|---|---|
| ブラウザー を起動する | URL 設定で設定した URL を使用して、デバッグを開始するときに既定のブラウザーを起動するかどうかを選択します。 |
| URL | .NET または .NET Core のホスト URL の場所を指定します。 プロジェクトに名前が付けられたプロファイル (つまり、launchSettings.json の commandName プロパティが Project ) の場合、Kestrel サーバーは指定されたポートをリッスンします。 IIS プロファイルの場合、これは通常、アプリの URLと同じ値です。 詳細については、「プロジェクトの構成」の「IIS 起動プロファイル」セクションを参照してください。 |
| アプリの URL | アプリケーション URL を指定します。 プロジェクトにちなんだプロファイルの場合、このプロパティは Kestrel サーバーの URL (通常は https://localhost:5001 と http://localhost:5000) を指定します。 |
Visual Studio には既定で IIS Express プロファイルが用意されており、IIS プロファイルなどの追加のプロファイルを作成できます。 これらの設定は、launchSettings.jsonの設定にも対応しています。 これら 2 つのプロファイルの種類には、ホスティング モデルなど、いくつかの設定が用意されています。
| 設定 | 説明 |
|---|---|
| ホスティングモデル | [処理中] (既定値) または [プロセス外] を指定します。 詳細については、ASP.NET Core ドキュメントの「ホスティング モデルの」を参照してください。 |
| アプリの SSL URL | IIS Express の場合、通常、アプリの SSL URL は http://localhost:44334. |
[ビルド] タブ
次の表は、デバッグに役立つビルド設定を示しています。 ビルド設定の詳細については、「ビルド ページ プロジェクト デザイナー」を参照してください。
| 設定 | 説明 |
|---|---|
| 一般的な>条件付きコンパイル シンボル | 選択されている場合は、DEBUG 定数と TRACE 定数を定義します。 これらの定数を使用すると、Debug クラス と trace クラス の条件付きコンパイルが可能になります。 これらの定数を定義すると、Debug クラスメソッドと Trace クラス メソッドによって、出力ウィンドウへの出力が生成されます。 これらの定数がないと、Debug クラスメソッドと Trace クラス メソッドはコンパイルされず、出力は生成されません。 通常、DEBUG はビルドのデバッグ バージョンで定義され、リリース バージョンでは未定義です。 TRACE は、デバッグ バージョンとリリース バージョンの両方で定義されます。 |
| General>コードの最適化 | 最適化されたコードにのみバグが表示されない限り、デバッグ ビルドではこの設定の選択を解除したままにします。 最適化されたコードはデバッグが困難です。これは、命令がソース コード内のステートメントに直接対応していないためです。 |
| デバッグ シンボル | コンパイラによって生成されるデバッグ情報の種類を指定します。 デバッグ シンボル を参照してください。 アプリケーションのデバッグ パフォーマンスを構成する方法については、「イメージのデバッグを容易にする」を参照してください。 |
| 出力>基本出力パス | 中間出力のベース フォルダーを指定します。 通常、出力はデバッグ ビルド bin\Debug に出力されます。 |
| 出力>基本中間出力パス | 中間出力のベース フォルダーを指定します。 通常、出力はデバッグ ビルド obj\Debug に出力されます。 |
デバッグ シンボル
デバッグ シンボルには、次のオプションを選択できます。
シンボルは出力されません
デバッグ情報が生成されませんを指定します。
PDB ファイル 、現在のプラットフォーム
PDB ファイルを生成します。これは、特にデバッガーなどの他のツールに、メイン実行可能ファイルの内容と生成方法に関する情報を提供するプラットフォーム固有のシンボル ファイルです。
PDB ファイル、移植可能
を生成します。PDB ファイル。プラットフォーム固有ではない移植可能なシンボル ファイル。他のツール、特にデバッガー、メイン実行可能ファイルの内容と生成方法に関する情報を提供します。 詳細については、ポータブル PDB の を参照してください。
DLL/EXE に埋め込まれています。プラットフォーム間で移植
ポータブル シンボル情報をアセンブリに埋め込みます。 外部の PDB ファイルは生成されません。
詳細については、/debug (C# コンパイラ オプション)を参照してください。