《ASP.NET Core In Action》讀書筆記系列四 建立ASP.NET Core 應用步驟及相應CLI命令

一般情況下，我們都是從一個模板（template)開始建立應用的（模板： 提供構建應用程式所需的基本程式碼）。本節使用 Visual Studio 2017 、ASP.NET Core2.0和 Visual Studio自帶的模板建立一個基本的ASP.NET Core 應用。當然你也可以使用 .NET CLI,它擁有同樣的模板。

本節將告訴你如何 建立應用，如何恢復依賴項，編譯應用程式，並執行它以檢視HTML輸出。示例雖是很簡單的 ， 只有三個不同的頁面，但它是一個完整的ASP.NET Core應用程式。建立一個ASP.NET Core應用並執行它，一般分為四步：

a、建立 - 從模板建立基礎應用程式；

b、還原 - 使用Nuget將所有程式包和依賴項還原到本地專案資料夾；

c、生成 - 編譯應用程式並生成應用；

d、執行 - 執行已編譯的應用程式；

建立ASP.NET Core 應用

使用模板可以快速建立並執行應用程式，它將自動為您配置許多基礎部分。 Visual Studio和.NET CLI附帶了許多用於構建Web應用程式的標準模板，控制檯應用程式和類庫。 要建立Web應用程式，請開啟Visual Studio並執行以下步驟：

1、檔案（File） > New （新建）> Project（專案）；

2、從左側的Templates節點中，選擇.NET Core，然後選擇ASP.NET Core Web應用程式;

3、輸入名稱，位置和解決方案名稱（可選），然後單擊“確定”，如下圖所示：

4、在下圖執行如下操作：

a、選擇ASP.NET Core 2.0，生成的應用程式將為ASP.NET Core2.0應用程式；

b、 選擇Web Application (Model-View-Controller) < Web 應用程式（模型 - 檢視 - 控制器）>， 它將建立一個傳統的，使用者在Web瀏覽器中檢視其生成的HMTL頁面的Web應用程式；另一個Web 應用程式 <Web Application> 模板,它使用新的ASP.NET Core 2.0 中的Razor Pages2 功能；Web API模板生成一個使用指定格式（JSON XML）為SPA(單頁面應用)和API返回資料的應用程式; Angular、React.js、React.js和Redux模板將生成指定的SPA（單頁面應用）應用程式；

c、確保未指定身份驗證；

d、確保未選中 “Enable Docker Support(啟用Docker支援)"；

e、點選Ok（確定）；

5、 等待Visual Studio從模板生成應用程式， 一旦Visual Studio完成生成應用程式，您將看有關ASP.NET Core的介紹頁面，Visual Studio為您的專案建立並添加了多個檔案，如下圖所示：

注意：如果你使用.NET CLI,請輸入如下指令來建立上面的應用（dotnet new mvc –o WebApplication2），-o引數，指示CLI在名為WebApplication2的子資料夾建立應用。

編譯ASP.NET Core 應用

此時，我們擁有執行應用程式所需的絕大部分檔案，但您離完成還著兩步了。 首先，您需要確保專案使用的所有依賴項恢復到您的本地目錄，其次，您需要編譯您的應用程式。 第一步不一定需要，因為Visual Studio和.NET CLI在首次建立專案時會自動恢復軟體包（在早期版本的.NET CLI（2.0之前）中，需要手工使用dotnet restore恢復依賴項）。 您可以選擇選單 Build> Build Solution來編譯應用程式，或者使用快捷鍵Ctrl + Shift + B，或者從命令列執行dotnet build命令，或者從Visual Studio的程式包管理器控制檯執行dotnet build 命令。 如果你使用Visual Studio 編譯，輸出視窗將顯示編譯進度。

注：一般情況Visual Studio and the .NET CLI會自動檢查應用程式的更改，並自動執行此步。

.NET Core跨平臺開發的基礎元件之一.NET Core命令列介面（CLI）,它提供了許多基本命令用於建立、構建和執行.NET Core應用程式。 Visual Studio會自動呼叫這些命令，同時，您也可以直接從命令列執行他們。 開發過程中最常見的命令有：

a、dotnet restore;

b、dotnet build;

c、dotnet run;

這些命令中需要在專案資料夾中執行。所有ASP.NET Core應用程式都依賴許多不同的外部應用程式庫，通過NuGet包管理器進行管理。這些依賴項顯示專案中，但不包括庫本身的檔案。在構建和執行應用程式之前，需要確保專案資料夾中存在每個依賴項有一個本地副本。dotnet restore，將確保應用程式的NuGet依賴項被複制到專案資料夾。如果你使用2.0版的.NET CLI，將不再需要顯式執行此命令。ASP.NET Core專案在專案的csproj檔案（XML檔案格式）中列出它們的依賴項。它將每個依賴項列為PackageReference節點，執行 dotnet restore命令時，它使用此檔案來確定要下載的NuGet包並複製到您的專案資料夾。dotnet build 命令 編譯應用程式。它將檢查應用程式是否有任何錯誤，如果沒有，將生成可以執行的應用程式，dotnet run 為執行應用的命令。每個命令都包含許多可以修改其行為的選項。檢視完整的可用命令列表，使用如下命令：

dotnet --help

檢視特定命令的可用選項（例如new，run）使用如下命令

dotnet new --help

執行ASP.NET Core 應用

現在 應 用程式已經準備就緒，可以使用多種方式來執行它。 在Visual Studio中，您可以單擊IIS旁邊工具欄上的綠色箭頭快速，或按F5快捷方式。 Visual Studio將自動開啟Web瀏覽器視窗為您提供適當的URL，在一兩秒後，您將看到您的全新應用程式，如下所示。可以使用.NET CLI工具從命令列執行命令 dotnet run  執行應用程式並使用命令列上提供的地址手動在Web瀏覽器中開啟URL。執行結果如圖所示：

預設情況下，此頁面顯示指向外部資源的各種連結以及頁面頂部的大橫幅廣告輪播（它會滾動顯示多個影象）。 在頁面頂部有三個連結：主頁，關於和聯絡人。 主頁連結是您當前的頁面上。 單擊“關於”或“聯絡人”將轉到新頁面，如下圖所示：

此時，選單各應用程式標題“WebApplication2”在所有三個頁面上都是相同的。 別外，頁面的標題（如瀏覽器的選項卡所示），跟當前頁面相匹配。 我們將在後面的介紹如何使用使用Razor模板實現這些功能。

謝謝你的閱讀，下節見！如果期待本系列，請點一下推薦！