JetBrains Rider 2024.1 ヘルプ

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

始める前に

  1. IIS Express をダウンロードしてインストールする (英語)

  2. ASP.NET Core アプリケーションをホストするために、IISExpress は ASP.NET Core モジュールに依存しています。必要なコンポーネントは、次の順序でインストールできます。

    1. インターネットインフォメーションサービス — Windows ボタン | Windows の機能をオンまたはオフにします

      Install IIS
    2. .NET Core ホスティングバンドル

  3. IIS Express 構成ファイル %\PROGRAMFILES(x86)%\IIS Express\config\templates\PersonalWebServer\applicationhost.config にモジュールがあるかどうかを確認できます。次の行の少なくとも 1 つがある場合、モジュールがインストールされています。

    <add name="AspNetCoreModule"... <add name="AspNetCoreModuleV2"...
  4. すべてが正しく構成されていれば、JetBrains Rider は必要なすべてのコンポーネントを自動的に検出します。JetBrains Rider 設定 Ctrl+Alt+Sビルド、実行、デプロイ | IIS Express ページでパスを確認できます。

    JetBrains Rider: IIS Express settings

実行 / デバッグ構成

新しい ASP.NET Core プロジェクトを作成するか、1 つ以上の IIS Express プロファイルを含む launchSettings.json ファイルを含む既存のプロジェクトをロードすると、JetBrains Rider はこれらのプロファイルに基づいて実行 / デバッグ構成を自動的に作成するになります。

作成した構成は、実行 / デバッグ構成ダイアログ(実行 | 実行構成の編集)またはツールバーセレクタで表示および編集できます。

JetBrains Rider: IIS Express run configuration

IIS Express プロファイルの場合、実行構成にはいくつかの追加オプションが含まれます。

applicationhost.config を生成します

ASP.NETCore アプリケーションで IISExpress を起動するために、JetBrains Rider は、IISExpress に付属のテンプレートを使用して作成された構成ファイル .idea/config/applicationhost.config を使用します。可能な場合は、このファイルに対して行ったカスタマイズも保持されます。大幅なカスタマイズを行う場合は、このオプションを無効にすることをお勧めします。

IIS Express の出力を表示する

このオプションは、IIS Express プロセスからの出力を有効にします。デフォルトでは無効になっています(出力はかなり冗長です)が、有効にするとアプリケーションを実行したときに詳細が表示されます。

JetBrains Rider: IIS Express output

デバッグ要求を送信する

このオプションを有効にすると、JetBrains Rider は最初のリクエストを(DEBUG HTTP リクエストメソッドを使って)ターゲットの ASP.NET Core アプリケーションに送信します。これにより、ブラウザーが起動していなくても、アプリケーションが起動され、デバッガーがアタッチされます。

追加の IIS Express 引数

このフィールドを使用すると、IIS Express ホストに追加の引数を渡すことができます(たとえば、要求の追跡を有効にするため)。

他の launchSettings ベースの実行構成と同様に、このダイアログを使用してターゲットフレームワークと追加のランタイム引数を指定できますが、一部の IISExpress 固有のオプションは launchSettings.json ファイルで直接構成する必要があります。

実行とデバッグ

すべてがインストールおよび構成されたら、プロジェクト Shift+F10 を実行するか、ブレークポイントを設定して(たとえば、Configure/ConfigureServices メソッドなどのアプリケーションの起動時でも)、コード Shift+F9デバッグできます。

自己署名 SSL 証明書を生成する

launchSettings ベースの実行構成の場合、JetBrains Rider は、マシンに ASP.NET Core 開発者証明書または IIS Express 自己署名証明書が設定されているかどうかを確認します。設定されていない場合は、証明書を生成するための通知が表示されます。

JetBrains Rider: Generating a self-signed SSL certificate

証明書のセットアップは、その警告から、または証明書を設定するアクションを使用して実行できます。証明書を設定するアクションは、アクションの検索 Ctrl+Shift+A を使用して見つけることができます。

ASP.NET Core の場合、JetBrains Rider は dotnet dev-certs https コマンドを使用して、証明書がインストールされているかどうかを確認します。IIS Express の場合、http.sys 証明書の設定を確認します(netsh http show sslcert コマンドラインと同様)。

また、証明書がシステムによって信頼されていることも確認します。これにより、開発者のマシンで SSL を利用する ASP.NET および ASP.NET CoreWeb アプリケーションの開発が容易になります。

関連ページ:

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

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

ブレークポイント

ブレークポイントを使用すると、特定のステートメントでプログラムの実行を一時停止し、変数値、コールスタック、その他のプログラムパラメーターを分析したり、式を評価したり、プログラムをステップ実行したりできます。JetBrains Rider では、次の型のブレークポイントを操作できます。行ブレークポイント、コード内の特定の文に設定できます。実行がこの行に達すると、デバッガーはプログラムの実行を中断します。行ブレークポイントは実行可能な行にのみ設定できます。コメント、宣言、空行は、行ブレークポイントの...

開始、一時停止、再開、停止

プロセス(アプリケーション、単体テスト、静的メソッド、または実行可能構成を持つもの)をデバッグするには、接続されたデバッガーでこのプロセスを実行する必要があります。デバッグセッションを開始する:デバッグセッションを開始するには、いくつかのオプションがあります。IDE からソースコードを開始できる場合は、を押すか、ツールバーのデバッグをクリックします。このようにして、現在選択されている実行 / デバッグ構成を、接続されているデバッガー(デバッグモード)で起動します。アプリケーションがすでに実行...

アクションとオプションを見つける

JetBrains Rider を使用すると、メニューを掘り下げることなく、アクションをすばやく見つけて適用できます。アクションとは、現在のキャレット位置で使用できる実行可能コマンド、またはツールウィンドウを開くコマンドなどのグローバルコマンドを意味します。また、名前で JetBrains Rider 設定を検索して移動したり、ポップアップメニューでブール値を使用して設定を変更したりすることもできます。アクションの検索と実行、または設定の検索と変更以下のいずれか 1 つを実行します: を押します。...

ASP.NET および ASP.NETCore アプリケーションを公開する

従来の ASP.NET Web アプリケーションを公開する:クラシック ASP.NET プロジェクトをデプロイするには、ソリューションエクスプローラーでプロジェクトを右クリックし、コンテキストメニューからを選択します。JetBrains Rider は、.zip ファイルの形式でデプロイパッケージを生成します。これは、MSDeploy コマンドラインを使用してデプロイできます。ASP.NET Core Web アプリケーションを公開する:JetBrains Rider では、2 つの実行構成を...