ASP.NET Core － Add a model

᳓前言

• 本篇文章由"Add a model to a Razor Pages app in ASP.NET Core"整理而成。

᳓重點整理

• 新增一個Model
• 新增與Model對應的Scaffold
• 初始化Migration

*重點1. 新增一個Model

• 右鍵點擊RazorPagesMovie專案 > 加入 > 新增資料夾，命名為Models
• 右鍵點擊Models資料夾 > 加入 > 新增項目 > Class，命名為Movie
• 在Movie class中加入以下的屬性

*重點2. 新增與Model對應的Scaffold

• 右鍵點擊Pages資料夾 > 加入 > 新增資料夾，命名為Movies
• 右鍵點擊Movies資料夾 > 加入 > 新增Scaffold項目 > Razor頁面 > 使用Entity Framework(CRUD)的Razor頁面

• 在模型類別(M)欄位選擇Movie(RazorPagesMovie.Models)、在資料內容類別(D)欄位選擇RazorPagesMovie.Models.RazorPagesMovieContext > 新增

• 加入完成後會自動建立下列資料夾及檔案：
• Data/RazorPagesMovieContext.cs
• Pages/Movies/Create, Delete, Details, Edit, Index
• 加入完成後會更新以下檔案：
• Startup.cs(※新增services.AddDbContext<RazorPagesMovieContext>(...))
• appsettings.json(※新增ConnectionStrings，可修改自動命名的資料庫名稱)

*重點3. 初始化Migration

• 工具 > NuGet套件管理員 > 套件管理器主控台

• 分別輸入以下兩個指令(※按下Enter送出並執行指令)
• Add-Migration InitialCreate(※新增一個命名為InitialCreate的Migration，執行後會於Migrations資料夾建立<time-stamp>_InitialCreate.cs檔案，自動產生用來建立Movie資料表的程式碼)
• Update-database(※執行<time-stamp>_InitialCreate.cs的Up方法，執行完畢會於C:\使用者\{user}建立資料庫檔案，含.mdf及.ldf)
• Ctrl+F5執行網頁，於網址輸入https://localhost:{port}/Movies測試網站是否運作正常

ASP.NET Core － Layout

᳓前言

• 本篇文章由"Layout in ASP.NET Core"整理而成。

᳓重點整理

• 預設的Layout配置
• Layout雜談
• 於Loyout參考多個Section

*重點1. 預設的Layout配置

• 於/Pages/_ViewStart.cshtml可指定預設的Layout參考檔案，只要是沒有在頁面中設定Layout屬性的頁面都會自動帶入。一開始建立專案時會預設為/Pages/Shared/_Layout.cshtml(含Header、Main Container、Footer)。

• 為了讓使用者在整個應用程式中有一致的操作感，一般而言Header及Footer每個頁面都會相同，因此透過獨立於_Layout.cshtml編輯可方便進行維護並減少冗餘的程式碼，且在整個應用程式中經常性被參考的靜態檔案也可於此統一管理。
• 不同頁面的主要內容則分成不同檔案編輯並在Main Container(※程式碼@RenderBody()，此為必須且只能插入一個，若無將會觸發Exception)中顯示。

*重點2. Layout雜談

• Layout屬性在頁面中並不是必需的，可不設定，或者設定為null。
• 在同一應用程式中可定義不只一個_Layout.cshtml以提供給不同頁面參考，而在頁面設定的Layout屬性會優先於_ViewStart.cshtml所設定的。
• _Layout.cshtml可建立在Shared以外的資料夾，但由於預設的搜尋路徑為/Shared、/Pages/Shared、/Views/Shared等，因此除此之外的路徑需要填寫完整的路徑才能正確參考。

*重點3. 於Layout參考多個Section

• 與@RenderBody()不同，透過多個@RenderSection()可於同一個Layout參考多個Section，可設定是否為必須，但若設定為必須卻搜尋不到參考內容時將會觸發，例如Exception@RenderSection("Scripts", required: true)。
• Section只能被定義並使用在Layout。
• Section可以藉由Partial Tag Helper參考特定的.cshtml，例如@section Scripts {<partial name="_ValidationScriptsPartial" />}。

ASP.NET Core － Get started

᳓前言

• 本篇文章由"Tutorial: Get started with Razor Pages in ASP.NET Core"整理而成。

᳓重點整理

• 建立一個Razor Pages網頁應用程式專案
• 簡介專案中的檔案

*重點1. 建立專案

• 開始使用 > 建立新的專案

• ASP.NET Core Web應用程式(※需確認最左下方的標籤為所要使用的語言，筆者曾不小心建立成VB的專案) > 下一步

• 修改專案名稱(RazorPagesMovie) > 瀏覽並選擇要建立專案資料夾的路徑 > 建立

• .NET Core > ASP.NET Core 3.1 > Web應用程式 > 建立

• 完成

*重點2. 簡介專案檔案

• pages資料夾：含Razor檢視(.cshtml)及Razor頁面(.cshtml、.cshtml.cs)，.cshtml含C#程式碼，可處理頁面的事件。(關於_Layout.cshtml等細節請參考"ASP.NET Core － Layout")
• wwwroot資料夾：預設加入bootstrap及jquery框架，因此有許多靜態檔案，比如.js、.css、.html等。
• appSettings.json：各種組態資料，比如資料庫的連接字串。
• Program.cs：程式的進入點。
• Startup.cs：設定應用程式的表現(behavior)，含Configure Method(建立處理應用程式要求的pipeline)及ConfigureServices Method(此為選擇性，可將應用程式的各種服務於此註冊)。

ASP.NET MVC 5 － Adding Validation

᳓前言

本篇文章將"Adding Validation"整理而成。

᳓重點整理

• 在Model類別中加入驗證邏輯，如此一來，在這個應用程式中對於該Model的所有新增、修改都會依照該邏輯進行驗證。
• ASP.NET MVC的其中一個核心設計概念為DRY(Don't Repeat Yourself)，意思是只需要指定功能或行為一次之後，在應用程式中有使用到的各部分就能夠體現出來。好處是能夠減少需要撰寫的程式碼，而且可以有效降低錯誤發生並方便維護。

᳓實作1. 修改Models/Movie.cs
首先要確認目前資料表的欄位，之後才能做比較。

開啟伺服器管理員->展開資料連接->展開Movies.mdf->右鍵dbo.Movies->選擇開啟資料表定義

尚未修改的dbo.Movies

修改Movie.cs，為各個欄位新增驗證邏輯。
在套件管理器主控台輸入Add-Midgration AddDataAnnotations，便會自動產生以下程式碼。
在套件管理器主控台輸入Update-database，執行完畢後再次查看資料表定義會發現已經變更完成。如此一來，當應用程式在變更資料表資料(呼叫SaveChanges方法)時，會優先判斷資料是否符合驗證邏輯，若是不符(比如必填欄位沒有資料)，便會拋出DbEntityValidationException的例外狀況，防止資料庫被存入不好的資料，增加應用程式的強健性。

修改後的dbo.Movies(StringLength：設定字串長度、Display：設定欄位顯示名稱、DataType：設定提示View如何顯示特定的資料、DisplayFormat：指定資料顯示的格式、Required：設定是否為必填項目、Range：設定值域、RegularExpression：設定輸入規則，可防止輸入空格、數字、特殊符號等)

ASP.NET MVC 5 － Adding a New Field

᳓前言

本篇文章將"Adding a New Field"整理而成。

᳓重點整理

• 在完全沒有資料庫檔案的狀況下，透過Code First建立資料庫及資料表。
• 在已經透過Code First建立的資料庫中，進行資料表的修改。

᳓實作1. 開啟Tools->NuGet Package Manager->Package Manager Console
記得先刪除在之前的練習中自動建立的App_Data/*.mdf檔案後再進行下列的練習。

᳓實作2. 啟用Migrations-在Package Manager Console輸入指令

1. 輸入"Enable-Migrations -ContextTypeName {WebApplication1}.Models.MovieDBContext"->Enter

2. 指令執行完畢後，會在專案中自動建立Migrations資料夾，且在該資料夾中新增Configuration.cs檔案

᳓實作3. 新增Migration-修改Migrations/Configuration.cs、在Package Manager Console輸入指令
修改完Congiguration.cs之後，一定要先重建專案，否則指令會執行失敗。當"add-migration Initial"指令執行完畢後，會自動產生所變更內容的{201804021004386}_Initial.cs檔案。需要注意的是，每次進行Code First Migrations (也就是輸入下一步的update-database指令)都會執行Seed()方法中的程式碼。

1. 輸入"add-migration Initial"->Enter

᳓實作4. 進行Code First Migrations-在Package Manager Console輸入指令
當"update-database"指令執行完畢，便已完成資料庫、資料表的建立，可開啟瀏覽器查看。

1. 輸入"update-database"->Enter

2. 網址列輸入"http://{localhost:port}/Movies/Index"

᳓實作5. 新增Rating新欄位-修改Models/Movie.cs、Controllers/MoviesController.cs、Views/Movies/Index.cshtml、Views/Movies/Create.cshtml、

接著要在Movie.cs新增一個Rating欄位，因此MoviesController.cs的Create Action需要增加Bind的欄位、Index.cshtml及Create.cshtml需要增加輸入欄位，而其他頁面，像是Edit.cshtml、Details.cshtml、Delete.cshtml也需要修改，但在這裡省略說明。值得注意的是，修改完畢後可以成功重建專案，但在瀏覽器瀏覽時會出現下圖的錯誤訊息，那是因為Model已經修改，但資料表還沒有更新，所以會以錯誤訊息提示必須更新資料表。

1. 網址列輸入"http://{localhost:port}/Movies/Index"

᳓實作6. 進行Code First Migrations-修改Migrations/Configuration.cs、在Package Manager Console輸入指令 為了使Model與資料表的內容一致，需要再次進行Code First Migrations，而每次進行Code First Migrations時都會重新執行一次Configuration.cs的Seed()，所以若是修改Configuration.cs便能將Rating欄位預設值輸入資料表中。值得注意的是，若之後只是修改預設值，並沒有更改欄位的話，可以直接執行"update-database"指令進行預設值的更新，不需要執行"add-migration"指令。

1. 輸入"add-migration Rating"->Enter

2. 輸入"update-database"->Enter

3. 網址列輸入"http://{localhost:port}/Movies/Index"可以看到Rating欄位已經輸入預設值"PG"

ASP.NET MVC 5 － Adding a Search

᳓前言

本篇文章將"Adding a Search Method and Search View"整理而成。

᳓重點整理

• 可直接在URL輸入參數便可作為字串進行標題的搜尋。
• 在View加入TextBox，可輸入文字並進行標題的搜尋。
• 在View加入DropDownList，可選擇類型並進行類型的搜尋。

᳓實作1. 修改Controllers/MoviesController.cs 
在Index Action新增searchString參數(當然也可以修改為直接利用URL Route的方式搜尋，請參考"ASP.NET MVC 5 － Adding a Controller")，並加入LINQ query程式碼。值得注意的是，LINQ query在初被定義時還沒執行，要等到Index Action回傳結果至View時才會執行。

1. 在網址列輸入"http://{localhost:port}/Movies/Index?searchString={searchString}"，按下Enter重新載入頁面即會顯示影片標題內含所搜尋字串的影片。

᳓實作2. 修改Views/Movies/Index.cshtml
然而經由修改URL的方式搜尋太不直覺，因此要在Index.cshtml頁面直接加入UI，提供輸入欄位以及控制按鈕，方便使用。

1. 一進入頁面就可以看到"BeginForm()"被編譯成<form>，其下含"TextBox()"被編譯成<input type="text">，以及<input type="submit">。(此時可直接利用UI進行搜尋，不需要添加與修改URL中的參數，Controller在執行時會自動取用對應id的元件值，若是將@Html.TextBox("searchString")改為@Html.TextBox("searchStrings")便會無法進行搜尋)

᳓實作3. 修改Views/Movies/Index.cshtml
光只是加入UI仍然沒有提供好的使用體驗，因為當使用者想要將搜尋結果分享給其他人的時候卻發現複製到的URL中並沒有附帶參數，不能夠直接顯示出搜尋的結果，所以要再進行一點修正，使用BeginForm("{Action Name}", "{Controller Name}", FormMethod.Get)。

1. 按下搜尋按鈕後，URL會自動添加"?searchString={searchString}"，因此該網址可直接複製至新頁面使用。

᳓實作4. 修改Controllers/MoviesController.cs、Views/Movies/Index.cshtml
接著練習加入下拉式選單至頁面中。利用LINQ query搜尋資料表中所有的類型，接著以Distinct()將重複的選項剔除後加入至List，最後將List的資料用ViewBag.SelectList({Collection.IEnumerable items}, "{Selected Value}")代入至View並顯示。

1. 一進入頁面就可以看到"DropDownList()"被編譯成<select>，除了資料庫中的類型外還增加了"全部"的選項，且預設選取"愛情片"。

C# － Function傳值和傳址的小測試

᳓重點整理
這是function透過傳值和傳址兩種方式傳入參數的小測試。傳值是只將function的參數值，設定成與輸入變數的值相同；而傳址則是直接將輸入變數作為function的參數使用，因此會造就以下幾點不同：

• 以傳值方式傳入的參數，在function中修改參數值也不會影響到輸入變數。
• 以傳址方式傳入的參數，在function中修改參數值會影響到輸入變數。
• 傳值跟傳址的function即使同名也視為不同的function，可正確執行。

᳓實作1. 建立專案
建立一個Windows Forms Application專案，並在Form拉入兩個Label、兩個Button。

᳓實作2. 修改FunctionRefTest.cs
加入兩個Button_Click事件、兩個function，並輸入以下程式碼，測試重點為在function中會修改參數值，並於function執行完畢後輸出變數值。

傳值測試：輸入變數值為4，輸出時不變。

傳址測試：輸入變數值為4，輸出時已被修改。