【T1a】ASP.NET Core の基本(2/4)

プロジェクトタイプ	ASP.NET Core (空)
プロジェクト名	`T1a`
ソリューション名	`PIT1`
ターゲットフレームワーク	.NET 8.0(長期的なサポート)
最上位レベルのステートメントを使用しない	使用する(チェックオフ)

1a-2. プロジェクトの作成と実行

まずは Web アプリケーション用のプロジェクトを作るところから学ぼう．

プロジェクトの新規作成時に「C#」「全てのプラットフォーム」「Web」を選択すると， _に示すようにいくつかのプロジェクトテンプレートが表示される．

ASP.NET Core (空)
- すべて手動設定するためのWebアプリケーション用のプロジェクトテンプレート
ASP.NET Core Web API
- Web API 用のプロジェクトテンプレート
ASP.NET Core Web アプリ
- ASP.NET Razor Pages 用のプロジェクトテンプレート
ASP.NET Core Web アプリ(Model-View-Controller)
- ASP.NET Core MVC 用のプロジェクトテンプレート

ここでは「ASP.NET Core (空)」タイプのプロジェクトを選択しよう．次にプロジェクト名とソリューション名を入力する(_)．上表に示すように，プロジェクト名にはT1a，ソリューション名にはPIT1と入力する．

_に示す画面では作成するプロジェクトについてのいくつかの設定を行うことができる．今回は_のように選択しよう．

プロジェクト作成時の追加情報の設定

項目	設定
ターゲットフレームワーク	.NET 8.0(長期的なサポート)
HTTPS用の構成	オフ(チェックを外す)
Dockerを有効にする	オフ(そのまま)
最上位レベルのステートメントを使用しない	オフ

「HTTPS用の構成」にチェックを入れたままプロジェクトを作成してしまった場合の対処方法

「HTTPS用の構成」にチェックを入れたままプロジェクトを作成してしまってもプロジェクトそのものの構成は通常と変わりはないので修正することは可能である．この場合，修正する必要があるのは開始方法に関する一部の設定のみである．まず，Program.cs に _のような記述があれば削除する ．

Program.cs内から削除する記述

1
app.UseHttpsRedirection();

次にProperties/launchSettings.jsonを編集する．この場合は_のようになっているはずである．

「HTTPS用の構成」にチェックを入れた場合のlaunchSettings.jsonの内容

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
  "iisSettings": {
    "windowsAuthentication": false, 
    "anonymousAuthentication": true, 
    "iisExpress": {
      "applicationUrl": "http://localhost:60453",
      "sslPort": 44303
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "WebApplication1": {
      "commandName": "Project",
      "launchBrowser": true,
      "applicationUrl": "https:*localhost:5001;http:*localhost:5???", // ←5???はプロジェクトごとに異なる
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

7行目のsslPortの部分を行ごと削除し，その前の行の行末のカンマを削除する．また，21行目のapplicationUrlの値をhttp://localhost:ポート番号に変更する．最終的にlaunchSettings.jsonは_のようになる ( プロジェクト名などのプロジェクトごとに異なる部分などが食い違ってしまうのでこれをそのまま使用しないこと )．

「HTTPS用の構成」にチェックを入れたままプロジェクトを作成してしまった場合の対処方法 : 閉じる

とりあえずこのまま何も変更せずに実行してみよう．実行する際はデバッグ実行の方法を指定するために， _に示す2か所を設定する必要がある．

①はアプリケーションの実行環境の指定でhttpが選択されていることを確認する． ②は表示に使用するウェブブラウザの指定でデバッグ実行時はここで指定したウェブブラウザが起動する．ここではFirefoxを選択する．

ではデバッグ実行を開始してみよう．Visual Studio 上部のボタンをクリックするか，F5キーを押下する．すると_のようなコンソールウィンドウ(黒画面)が表示され，ウェブブラウザが起動してhttp://localhost:ポート番号/が開かれる． ポート番号の部分はプロジェクトごとに異なるので注意しよう．

このページには_のように Hello World! とだけ表示されるはずである．なお，ASP.NET Core ファミリのプロジェクトを初回起動する場合は，_のようなダイアログが表示される場合があるので「OK」をクリックし，次の_のダイアログでは「はい」を選択しよう．また，Firefox を起動した際にデフォルトのウェブブラウザが Firefox 以外である場合に， _のように表示されることがあるが，必ずしも Firefox をデフォルトのウェブブラウザに設定する必要はない(してもよい)ので，各自その要否を判断して選択しよう．

くわえて稀に_のようなエラーが表示される場合がある．その場合はデバッグ停止のボタンをクリックして起動しなおすとよい．

ウェブブラウザを閉じるとデバッグ実行も自動的に終了する．コンソールウィンドウ(黒画面)には_のように表示され，何かキーを押下すればこの画面は閉じる．ちなみに，コンソールウィンドウ(黒画面)が開いたことからわかるように，「ASP.NET Core Web アプリケーション」は基本的に今まで作成してきたコンソールアプリケーションと同様のものであると考えてよい．

Last updated on 2024-04-12
Published on 2024-04-12