C# 以ASP.NET Core 建立WebApi (.net 6.0)專案 從頭開始 Part 1

莊創偉
Jul 26, 2021

.NetCore 本身有許多實用的專案範本。但為了更了解細部設定所以先選擇建立一個 Empty 專案。

Empty 專案只有少少三個檔案加一個資料夾,而 appsettings.json雖然 Empty專案也會預先配置好,但是並沒有使用到,所以嚴格來說只有兩個檔案。

其中 Program.cs 為程式的進入點,launchSettings.json為啟動參數的設定。
這兩個檔案名稱跟位子都是不能亂改及調整的。

Empty 專案

launchSettings.json 由專案屬性調整,原則上不需要手動編輯。

直接按 F5 啟動,會開啟一個CLI 與一個 https://localhost:5001/ 的網頁。

這些啟動的設定就是寫在 launchSettings.json

launchSettings.json 內容

iisSettings: 顧名思義就是給 IIS 讀的。當啟動的方式為 IIS時便會去讀取這裡的設定。

profiles :啟動方式(綠色箭頭)對應的設定檔。
commandName:定義啟動方式 Project 為輕量的執行端,比使用 IIS快上許多。*如果有需要結合 AD 進行測試,必須使用 IIS
launchBrowser:是否開啟網頁。
environmentVariables:設定環境變數。

Program.cs

Program.cs 只有少少的幾行,其中最主要的就是 WebApplication這個 6.0 新增的類別。將IHOST包在裡面,簡化了不少設定,所以只要設定個端點,就可以喚起API 服務了。

--

--

莊創偉

學海無涯。但是為了生計還是得下海的風塵男子