起動プロファイルを使用して .NETCore および ASP.NETCore アプリを実行およびデバッグする

.NET Core または ASP.NET Core アプリケーションでは、launchSettings.json を使用して起動プロファイルを設定できます。これらのプロファイルは対応する実行 / デバッグ構成に自動的にインポートされ、これを使用してアプリケーションを実行およびデバッグできます。ASP.NET Core アプリの起動設定プロファイルは、IIS Express でこれらのアプリを実行およびデバッグするためによく使用されます。

launchSettings.json とは何ですか

プロジェクトの Properties フォルダーに配置される launchSettings.json は、アプリケーションの起動方法（実行するコマンド、ブラウザーを開くかどうか、どの環境変数を設定するかなど）を記述します。この情報は、JetBrains Rider、dotnet run、またはその他のツールで使用して、アプリケーションを実行またはデバッグできます。

この記事は、launchSettings.json で使用されている規則の詳細を示しています。以下の例は、2 つの起動プロファイル IIS Express と Sample を持つサンプル launchSettings.json を示しています。

{
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iisExpress": {
      "applicationUrl": "http://localhost:43347",
      "sslPort": 44364
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "Sample": {
      "commandName": "Project",
      "launchBrowser": true,
      "applicationUrl": "https://localhost:5001;http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Staging"
      }
    }
  }
}
        

launchSettings.json に基づいて実行 / デバッグ構成を作成する

初めて launchSettings.json でプロジェクトを開くと、JetBrains Rider は利用可能な起動プロファイルを選択し、対応する実行 / デバッグ構成を自動的に作成します。これを使用してプロジェクトを実行およびデバッグできます。

例: Orchard CMS(英語) を複製して開いた後、JetBrains Rider は launchSettings.json ファイルから次の実行 / デバッグ構成を作成します。

JetBrains Rider: Creating run/debug configurations based on launchSettings.json

JetBrains Rider は、実行構成が以前にソリューションで作成されていない場合にのみ、実行 / デバッグ構成を自動的に生成します。既存の実行 / デバッグ構成がある場合、または自動生成された構成を削除する場合は、ソリューションエクスプローラーで launchSettings.json を右クリックし、構成を生成するを選択して、プロジェクトの起動プロファイルを実行 / デバッグ構成にインポートできます。

起動プロファイルの実行とデバッグ

起動プロファイルが実行 / デバッグ構成としてインポートされたら、ツールバーで対応する構成を選択して実行またはデバッグをクリックできます。

プロジェクトに launchSettings.json があり、対応する実行 / デバッグ構成がない場合は、ソリューションエクスプローラーでプロジェクトを右クリックし、実行 '...' またはデバッグ '...' を選択できます。この場合、JetBrains Rider は、プロジェクトの launchSettings.json の最初の起動プロファイル用に一時的な実行 / デバッグ構成を作成し、それを実行します。

エディターで launchSettings.json を開き、ガターのアイコンを使用して起動プロファイルを実行またはデバッグすることもできます。

この場合、JetBrains Rider はこのプロファイル用の一時的な実行 / デバッグ構成も作成します。

起動設定プロファイルを編集する

起動プロファイルに基づく実行 / デバッグ構成には、2 種類のパラメーターが含まれます。

ファイルを編集することによって構成できる launchSettings.json からのパラメーター - 編集時に構文のハイライト、コード分析、コード補完を使用します。
使用するターゲットフレームワークや .NET ランタイム引数など、JetBrains Rider によって追加された追加の構成パラメーター。これらのパラメーターを構成するには、メニューから実行 | 実行構成の編集を選択し、対応する構成を選択します。
launchSettings.json からのパラメーターは読み取り専用として表示されます。他のすべてのパラメーターは編集可能です:

「.NET 起動設定プロファイル」実行構成の設定


プロジェクト:	この構成用のスタートアッププロジェクトを選択してください。
ターゲットフレームワーク:	この構成を実行するために使用される .NET フレームワークバージョン。
プロファイルを起動します。	このセレクタを使用して、launchSettings.json ファイルに設定されているプロファイルの 1 つを選択します。
Exe パス:	選択した対象プロジェクトの実行ファイルへのパスが自動計算されます。
プログラム引数:	構成が開始されたときに実行可能ファイルに渡される引数。複数の引数は空白で区切る必要があります。一部のプロジェクトタイプ（たとえば、Web アプリケーション）では、ターゲットプロジェクトを正しく開始できるように、JetBrains Rider がこのフィールドに自動的に入力します。
作業ディレクトリ:	作業ディレクトリは、選択したターゲットプロジェクトの bin/Debug パスに自動的に設定されます。
環境変数:	ここでは、ターゲット実行可能ファイルのカスタム環境変数(英語)を指定できます。
外部コンソールを使用する:	デフォルトでは、.NET および Mono アプリケーションの出力は、実行またはデバッグウィンドウに表示されます。このチェックボックスを使用して、出力を外部ウィンドウに表示します。このチェックボックスは、従来の .NET アプリケーションタイプ（たとえば、.NET コンソールアプリケーション）には影響しません。それらの出力は常に外部ウィンドウに表示されます。
.NET ランタイム引数:	dotnet と Mono はどちらも、アプリケーションの起動時にカスタムランタイム引数の設定をサポートしています。たとえば、Mono は、アプリケーションの実行方法をカスタマイズするための多くのランタイム引数(英語)をサポートしています(英語)。使用するガベージコレクター（`--gc=boehm` または `--gc=sgen`）を選択できます。macOS では、使用するランタイムアーキテクチャー（`--arch=32` または `--arch=64`）などを選択できます。
mono ランタイムを使用	Windows で作業している場合は、アプリケーションが mono ランタイムでどのように機能するかを確認できます。JetBrains Rider は、JetBrains Rider 設定 `Ctrl+Alt+S` のビルド、実行、デプロイ \| ツールセットおよびビルドページで指定された mono 実行可能ファイルを使用します。 mono ランタイムでデバッグするには、以下が必要です。 Mono 4.2+ プロジェクト内のポータブル PDB - .csproj ファイル内の `<debugtype>portable</debugtype>`、または pdb2mdb を使用して mdb を生成します。
IIS Express 起動プロファイルでは、次の 4 つのオプションを使用できますは、プロファイルを起動 : セレクターで選択されます。
applicationhost.config を生成します	ASP.NETCore アプリケーションで IISExpress を起動するために、JetBrains Rider は、IISExpress に付属のテンプレートを使用して作成された構成ファイル .idea/config/applicationhost.config を使用します。可能な場合は、このファイルに対して行ったカスタマイズも保持されます。大幅なカスタマイズを行う場合は、このオプションを無効にすることをお勧めします。
IIS Express の出力を表示する	このオプションは、IIS Express プロセスからの出力を有効にします。デフォルトでは無効になっています（出力はかなり冗長です）が、有効にするとアプリケーションを実行したときに詳細が表示されます。
デバッグ要求を送信する	このオプションを有効にすると、JetBrains Rider は最初のリクエストを（`DEBUG` HTTP リクエストメソッドを使って）ターゲットの ASP.NET Core アプリケーションに送信します。これにより、ブラウザーが起動していなくても、アプリケーションが起動され、デバッガーがアタッチされます。
追加の IIS Express 引数	このフィールドを使用すると、IIS Express ホストに追加の引数を渡すことができます（たとえば、要求の追跡を有効にするため）。

最終更新日: 2024 年 2 月 11 日

関連ページ：

実行 / デバッグ構成

JetBrains Rider は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、デプロイ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。実行 / デバッグ構成には 2 つのタイプがあります。一時的 — エディターから .NET 静的メソッドを実行 / デバッグするたびに作成されます。永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成されます。永続的な構成は、削除するま...

デバッグ

デバッガーは JetBrains Rider の不可欠な部分であり、これを使用すると、アプリケーションの実行時の動作を調べたり、問題のあるコードを特定したり、問題の原因を段階的に特定したりできます。典型的なデバッグ手順デバッグするプログラムの実行 / デバッグ構成を定義します。潜在的な問題が存在する可能性のあるソースコード内のブレークポイントの設定、プログラムをデバッグモードで起動するか、実行中のプロセスに接続して、デバッグを開始します。プログラムの実行が中断した場合は、コードをステップ実行し、...

IISExpress で ASP.NETCore アプリを実行およびデバッグする

始める前に：IIS Express をダウンロードしてインストールする、ASP.NET Core アプリケーションをホストするために、IISExpress は ASP.NET Core モジュールに依存しています。必要なコンポーネントは、次の順序でインストールできます。インターネットインフォメーションサービス — 、.NET Core ホスティングバンドル、IIS Express 構成ファイル %\PROGRAMFILES(x86)%\IIS Express\config\templates\Per...

デバッグウィンドウ

デバッガーセッションを開始すると、デバッグツールウィンドウが開きます。このウィンドウを使用して、デバッガーセッションを制御し、プログラムデータ (フレーム、スレッド、変数など) を表示および分析し、デバッガーアクションを実行します。デフォルトでは、プログラムがブレークポイントに到達したときにデバッグツールウィンドウが開き、セッションが終了しても非表示になりません。この動作を変更するには、ビルド、実行、デプロイ | デバッガー設定ページに移動し、ブレークポイントでデバッグウィンドウを表示するチェ...

ASP.NET スキャフォールディング

スキャフォールディングは、ASP.NET プロジェクトのコントローラー、ビュー、その他の項目をすばやく作成するのに役立つツールです。新しい scaffold アイテムを追加するソリューションエクスプローラーで目的のノードを右クリックし、を選択します。開いたポップアップで、追加する scaffold のタイプを選択し、名前を入力します。JetBrains Rider は、ボイラープレートコードを含むすべての必要なディレクトリとファイルをプロジェクトに追加します。JetBrains Rider は、...