builder.Services.AddSingleton<IRepository, EmployeeRepository>();

• using ModelBindingValidation.Models;var builder = WebApplication.CreateBuilder(args);// Add services to the container.builder.Services.AddSingleton<IRepository, EmployeeRepository>();builder.Services.AddControllersWithViews();var app = builder.Build();...

  現(xiàn)在運行項目并且進入URL– /Home/Index/1，將看到employee為1的員工編號顯示在瀏覽器，圖片如下:

  2 理解模型綁定

  ASP.NET Core模型綁定在整個過程發(fā)揮什么作用呢？我們請求的URL包含了employee id的值(給與第三段的URL是1) /Home/Index/1

  在Program.cs 類中有默認路由，路由指定了3個URL段，Id是變量
  • app.MapControllerRoute( name: "default", pattern: "{controller=Home}/{action=Index}/{id?}" );

    現(xiàn)在，我們看到Index方法有一個Id參數(shù)
    • public IActionResult Index(int id = 1){ return View(repository[id]);}

      ASP.NET Core模型綁定處理過程從URL中獲取的Id值，并且將Id值通過參數(shù)提供給action方法
      

      模型綁定會從下面3個地方查詢值：

      1 表單數(shù)據(jù)值

      2 路由變量

      3 查詢字符串

      從表單數(shù)據(jù)開始檢查，然后路由變量，最后是查詢字符串，在這種情況下，框架如果沒有在表單數(shù)據(jù)中發(fā)現(xiàn)Id的值, 接著會檢查路由變量，發(fā)現(xiàn)有個路由變量的值叫Id，然后停止搜索， 接下來不會搜索查詢字符串
      搜索順序是非常重要，如果我們打開URL– /Home/Index/2?id=1 ，然而我們將會看到Employee Id 為2的記錄, 如下圖所示:

      這是為什么Employee 為2的員工被顯示，因為在查詢字符串Id的值(即1)之前框架在路由變量中發(fā)現(xiàn)了Id(即2)值，因此2的值被提供給action方法參數(shù)，如果我們打開URL-Home/Index?id=3，然而Employee Id為3的員工將被顯示：

      在這種情況下，框架沒有發(fā)現(xiàn)Id的值在URL段，因此它將搜索查詢字符串發(fā)現(xiàn)Id為3的值
      3 模型綁定默認值

      如果ASP.NET Core在這三個地方?jīng)]有發(fā)現(xiàn)綁定的值，會發(fā)生什么呢？– 表單數(shù)據(jù)值，路由變量&查詢字符串，在這種情況下，它將根據(jù)action方法定義的類型提供默認值，這些默認值是:

      1 int類型為0

      2 string類型為""

      3 時間類型為01-01-0001 00:00:00

      4 float類型為0

      在Index方法代碼中我們測試一下模型綁定默認值：
      • public IActionResult Index(int id){ if (id == 0) id = 1; return View(repository[Convert.ToInt32(id)]);}

        我們把參數(shù)id默認值移除掉，接下來我們在Index方法中打斷點，然后運行應用程序并且進入URL – /Home/Index，注意在這個url中沒有給定第三個參數(shù)employee id，因此 現(xiàn)在模型綁定將提交默認值，當斷點命中時，我們將鼠標移動到id變量上檢查一下值，你將看到值0，如下圖所示:
        當ASP.NET Core 沒有給employee id 值，因此它會為id參數(shù)綁定默認值，Id參數(shù)是int類型，默認值是0，因此模型綁定提供了默認值為0
        
        你能獲取到它 – 如果Id參數(shù)類型修改為string，然而模型綁定將給與默認值""

        我們數(shù)據(jù)中沒有員工Id為0，因此我們在if代碼塊中賦值為1，這將幫助我們阻止運行時錯誤，我們可以通過使用Try-Catch 塊處理運行時錯誤

        注意可空類型的默認值為，現(xiàn)在修改Index方法有一個able int類型參數(shù)，代碼如下：

        • public IActionResult Index(int? id){ if (id == ) id = 1; return View(repository[Convert.ToInt32(id)]);}

          運行你的應用程序并且進入URL– /Home/Index，現(xiàn)在通過斷點來檢查id的值, 這時你將發(fā)現(xiàn)它的值為
          

          4 模型綁定簡單類型

          當ASP.NET Core 綁定簡單類型時，將會把值轉換為方法的參數(shù)類型，簡單類型是– string,int,bool,float,datetime,decimal等
          讓我們通過一個簡單的例子來了解一下：
          • public IActionResult Index(int? id){ if (id == ) id = 1; return View(repository[Convert.ToInt32(id)]);}

            Index方法參數(shù)是int類型因此ASP.NET Core 框架會自動轉換url中id段變量的值到int值
            案例 1 : 針對 URL – /Home/Index/1
            當強求的URL包含的id值為int，像– /Home/Index/1 框架會成功轉換1的值到int，因此方法參數(shù)會收到參數(shù)為1
            案例 2 : 針對 URL – /Home/Index/John

            如果你收到要給URL，Id值是字符串 像– /Home/Index/John 在這種情況下，框架將嘗試把John轉換到int值，這時不能轉化，因此action 方法接收到id的參數(shù)為

            5 模型綁定復雜類型
            當action方法的參數(shù)是復雜類型，像類對象，然而模型綁定會指定綁定每個復雜類型的公共屬性

            模型綁定查找公共屬性從下面三個地方：

            1 表單數(shù)據(jù)
            2 路由變量
            3 查詢字符串
            這個是非常重要的感念，你將在你的項目中再次使用，面試時也經(jīng)常問到這個問題，因此我們創(chuàng)建一個例子理解它

            在Home Controller中添加Create方法，這兩個方法如下：

            • public IActionResult Create() => View();[HttpPost]public IActionResult Create(Employee model) => View("Index", model);

              HTTP GET版本的Create方法選擇默認View并且沒有傳遞任何模型給它，HTTP POST 版本的Create方法有一個Employee參數(shù)的類型(是一個復雜類型)
              

              模型綁定的功能是從Http請求中提取Employee類公共屬性，并且將它提供給Create方法的參數(shù)，該方法傳遞Employee模型對象到默認View

              接下來在Views->Home 文件夾下創(chuàng)建Create View，它的代碼給與如下：
              • @model Employee@{ ViewData["Title"] = "Create Employee";}<h2>Create Employee</h2><form asp-action="Create" method="post"> <div class="form-group"> <label asp-for="Id"></label> <input asp-for="Id" class="form-control" /> </div> <div class="form-group"> <label asp-for="Name"></label> <input asp-for="Name" class="form-control" /> </div> <div class="form-group"> <label asp-for="DOB"></label> <input asp-for="DOB" class="form-control" /> </div> <div class="form-group"> <label asp-for="Role"></label> <select asp-for="Role" class="form-control" asp-items="@new SelectList(Enum.GetNames(typeof(Role)))"></select> </div> <button type="submit" class="btn btn-primary">Submit</button></form>

                這個View包含了一個表單并且綁定了Employee實體一些公共屬性，當表單被提交這些值將被提交到HTTP POST版本的Create方法
                
                Create方法需要Employee對象的參數(shù)，因此模型綁定過程首先從表單數(shù)據(jù)中查找Employee對象的每個公共屬性的值(Id, Name, DOB, Role)
                表單數(shù)據(jù)包含了這些值，使用asp-for幫助標簽作為輸入元素，例如-示例–id屬性綁定到輸入控件，如下所示
                <input asp-for="Id" class="form-control" />

                Name屬性被綁定通過下面這種方式

                <input asp-for="Name" class="form-control" />

                模型綁定會把這些值綁定到Employee對象的屬性，將Employee對象傳遞給Create方法的參數(shù)，Create方法使用模型綁定技術獲取employee類型的參數(shù)值
                
                asp-for 是一個幫助標簽，你可以獲取到更多的關于內置幫助標簽在ASP.NET Core
                Post版本的Create方法調用Index視圖，將Employee對象作為Model傳遞給View，現(xiàn)在運行應用程序并且進入URL– /Home/Create，在表單中輸入所有值并點擊提交按鈕，我們會看到填充的值顯示在瀏覽器上

                下面2張圖片顯示了填充和提交的表單:

                6 復雜對象包含復雜對象

                EmployeeDetails.cs類包含了名稱為HomeAddress公共屬性，這個屬性是一個Address類型，因此復雜對象包含另一個復雜對象案例

                • public class Employee{ public int Id { get; set; } public string Name { get; set; } public DateTime DOB { get; set; } public Address HomeAddress { get; set; } public Role Role { get; set; }}public class Address{ public string HouseNumber { get; set; } public string Street { get; set; } public string City { get; set; } public string PostalCode { get; set; } public string Country { get; set; }}

                  綁定HomeAddress屬性時，模型綁定處理過程和前面的相同:
                  

                  1 查找所有HomeAddress的公共屬性(即 HouseNumber, Street, City, PostalCode, Country)
                  2 在表單數(shù)據(jù)中搜索這些公共屬性的值，注意路由&查詢字符串變量不能包含復雜類型

                  更新Create.cshtml視圖文件綁定HomeAddress類型所有屬性，代碼如下：

                  • @model Employee@{ ViewData["Title"] = "Create Employee";}<h2>Create Employee</h2><form asp-action="Create" method="post"> <div class="form-group"> <label asp-for="Id"></label> <input asp-for="Id" class="form-control" /> </div> <div class="form-group"> <label asp-for="Name"></label> <input asp-for="Name" class="form-control" /> </div> <div class="form-group"> <label asp-for="DOB"></label> <input asp-for="DOB" class="form-control" /> </div> <div class="form-group"> <label asp-for="Role"></label> <select asp-for="Role" class="form-control" asp-items="@new SelectList(Enum.GetNames(typeof(Role)))"></select> </div> <div class="form-group"> <label asp-for="HomeAddress.HouseNumber"></label> <input asp-for="HomeAddress.HouseNumber" class="form-control" /> </div> <div class="form-group"> <label asp-for="HomeAddress.City"></label> <input asp-for="HomeAddress.City" class="form-control" /> </div> <div class="form-group"> <label asp-for="HomeAddress.Street"></label> <input asp-for="HomeAddress.Street" class="form-control" /> </div> <div class="form-group"> <label asp-for="HomeAddress.PostalCode"></label> <input asp-for="HomeAddress.PostalCode" class="form-control" /> </div> <div class="form-group"> <label asp-for="HomeAddress.Country"></label> <input asp-for="HomeAddress.Country" class="form-control" /> </div> <button type="submit" class="btn btn-primary">Submit</button></form>

                    當綁定HomeAddress屬性時候，我們必須包含"HomeAddress"，看Helper標簽asp-for="HomeAddress.HouseNumber" 綁定HouseNumber屬性，我們也為另一些屬性使用這種綁定

                    編輯Index視圖顯示HomeAddress對象所有屬性，代碼如下:
                    • @model Employee@{ ViewData["Title"] = "Index";}
                      <h2>Employee</h2>
                      <table class="table table-sm table-bordered table-striped"> <tr><th>Id:</th><td>@Model.Id</td></tr> <tr><th>Name:</th><td>@Model.Name</td></tr> <tr><th>Date of Birth:</th><td>@Model.DOB.ToShortDateString()</td></tr> <tr><th>Role:</th><td>@Model.Role</td></tr> <tr><th>House No:</th><td>@Model.HomeAddress?.HouseNumber</td></tr> <tr><th>Street:</th><td>@Model.HomeAddress?.Street</td></tr> <tr><th>City:</th><td>@Model.HomeAddress?.City</td></tr> <tr><th>Postal Code:</th><td>@Model.HomeAddress?.PostalCode</td></tr> <tr><th>Country:</th><td>@Model.HomeAddress?.Country</td></tr></table>

                      現(xiàn)在，運行應用程序并且進入URL– /Home/Create, 填充并提交表單，我們將發(fā)現(xiàn)address類型屬性的顯示,顯示圖片如下：

                      檢查源代碼

                      下面是瀏覽器為html生成的源代碼

                      • <div class="form-group"> <label for="HomeAddress_HouseNumber">HouseNumber</label> <input class="form-control" type="text" id="HomeAddress_HouseNumber" name="HomeAddress.HouseNumber" value="" /></div><div class="form-group"> <label for="HomeAddress_City">City</label> <input class="form-control" type="text" id="HomeAddress_City" name="HomeAddress.City" value="" /></div><div class="form-group"> <label for="HomeAddress_Street">Street</label> <input class="form-control" type="text" id="HomeAddress_Street" name="HomeAddress.Street" value="" /></div><div class="form-group"> <label for="HomeAddress_PostalCode">PostalCode</label> <input class="form-control" type="text" id="HomeAddress_PostalCode" name="HomeAddress.PostalCode" value="" /></div><div class="form-group"> <label for="HomeAddress_Country">Country</label> <input class="form-control" type="text" id="HomeAddress_Country" name="HomeAddress.Country" value="" /></div>

                        HouseNumber輸入控件獲取屬性名字的值HomeAddress.HouseNumber，然而id屬性的值變?yōu)镠omeAddress_HouseNumber，相同的方式，City輸入控件獲取name屬性的值，然而id的屬性的值為 HomeAddress_City
                        

                        在C#代碼中我們也能獲取HouseNumber值在action 方法通過使用Request.Form方法，代碼如下：
                        string houseNo = Request.Form["HomeAddress.HouseNumber"];

                        針對另外一些值也是相同的方式
                        
                        7 使用[Bind(Prefix)]特性綁定復雜類型

                        [Bind(Prefix)]特性能修改復雜類型模型綁定的默認行為，讓我們通過一個例子來理解，創(chuàng)建一個名為PersonAddress.cs的模型類使用下面代碼：

                        • namespace AspNetCore.ModelBinding.Models{ public class PersonAddress { public string City { get; set; } public string Country { get; set; } }}
                          

                          接下來，在HomeController類中添加一個新的action方法叫DisplayPerson
                          
                          • [HttpPost]public IActionResult DisplayPerson(PersonAddress personAddress){ return View(personAddress);}

                            下一步，修改Create視圖中asp-action標簽的值，將該值設置為DisplayPerson，代碼如下：

                            • <form asp-action="DisplayPerson" method="post"> ...</form>

                              現(xiàn)在，意味著當我們在表單中輸入數(shù)據(jù)并且提交表單時，數(shù)據(jù)將被提交到DisplayPerson方法 ，在Views->Home文件夾創(chuàng)建一個DisplayPerson視圖，這個視圖包含PersonAddress類型，并顯示城市和國家在模型對象
                              DisplayPerson視圖代碼如下：
                              • @model PersonAddress@{ ViewData["Title"] = "Person";}<h2>Person</h2><table class="table table-sm table-bordered table-striped"> <tr><th>City:</th><td>@Model.City</td></tr> <tr><th>Country:</th><td>@Model.Country</td></tr></table>

                                現(xiàn)在運行你的應用程序，并且進入URL- /Home/Create，填充表單并且點擊提交按鈕
                                

                                注意City和Country沒有包含任何值，模型綁定失敗了，看如下圖：

                                模型綁定失敗的原因是因為City和Country輸入控件屬性Name包含了字符串HomeAddress 前綴，在瀏覽器中檢查輸入控件源代碼

                              <input class="form-control" type="text" id="HomeAddress_City" name="HomeAddress.City" value=""><input class="form-control" type="text" id="HomeAddress_Country" name="HomeAddress.Country" value="">

                              為了解決這個問題，我們在action方法的參數(shù)中應用[Bind(Prefix)]，告訴ASP.NET Core 基于HomeAddress前綴完成模型綁定

                              因此改變DisplayPerson 方法包含[Bind(Prefix = nameof(Employee.HomeAddress))]顯示如下：
                              • public IActionResult DisplayPerson([Bind(Prefix = nameof(Employee.HomeAddress))] PersonAddress personAddress){ return View(personAddress);}

                                再次提交表單，這次我們將發(fā)現(xiàn)City和Country值并將他們顯示在瀏覽器，看下面圖片:

                                使用[Bind]選擇性的綁定屬性

                                我們可以選擇性的綁定屬性，Bind()方法的第一個參數(shù)提供包含模型綁定中的所有屬性的名稱(用逗號分隔的列表中)，那意味著剩下的屬性將不被綁定
                                修改DisplayPerson方法代碼，綁定方法包含City屬性
                                • public IActionResult DisplayPerson([Bind(nameof(PersonAddress.City), Prefix = nameof(Employee.HomeAddress))] PersonAddress personAddress){ return View(personAddress);}

                                  測試一下該方法，你將看到僅僅City值顯示，如下圖所示：

                                  我們可以使用另外一種方法實現(xiàn)相同的功能，在PersonAddress類的Country屬性上使用 [BindNever] 特性，BindNever指定的屬性模型綁定將被忽略

                                  • using Microsoft.AspNetCore.Mvc.ModelBinding;namespace AspNetCore.ModelBinding.Models{ public class PersonAddress { public string City { get; set; } [BindNever] public string Country { get; set; } }}
                                    

                                    8 模型綁定上傳文件
                                    

                                    我們通過模型綁定技術完成上傳文件功能，這里我們必須做3件事情：

                                    1 在View中添加input type=”file”控件

                                    2 在html表單的標簽中添加enctype="multipart/form-data"特性

                                    3 在action方法中添加IFormFile類型參數(shù)，使用該參數(shù)綁定上傳文件

                                    我們創(chuàng)建一個上傳文件的特性，添加一個新的Controller并且命名為FileUploadController.cs. 代碼給與如下:

                                    • using Microsoft.AspNetCore.Mvc;
                                      namespace ModelBindingValidation.Controllers{ public class FileUploadController : Controller { private IWebHostEnvironment hostingEnvironment; public FileUploadController(IWebHostEnvironment environment) { hostingEnvironment = environment; } public IActionResult Index() => View(); [HttpPost] public async Task<IActionResult> Index(IFormFile file) { string path = Path.Combine(hostingEnvironment.WebRootPath, "Images/" + file.FileName); using (var stream = new FileStream(path, FileMode.Create)) { await file.CopyToAsync(stream); } return View((object)"Success"); } }}

                                      添加一個IWebHostEnvironment 的依賴用來獲取"wwwroot"文件夾的全部路徑, Index方法通過模型綁定技術將上傳的文件綁定到IFormFile類型參數(shù)
                                      

                                      方法內部將文件保存到應用程序wwwroot/Images文件夾內

                                      為了能夠正常工作你確保在wwwroot目錄下創(chuàng)建Images文件夾，接下來在 Views/FileUpload文件夾內添加Index文件，代碼如下：

                                      • @model string@{ ViewData["Title"] = "Upload File";}
                                        <h2>Upload File</h2><h3>@Model</h3>
                                        <form method="post" enctype="multipart/form-data"> <div class="form-group"> <input type="file" name="file" /> </div> <button type="submit" class="btn btn-primary">Submit</button></form>

                                        瀏覽器看上如下：
                                        

                                        總結：

                                        在ASP.NET Core中模型綁定是一個重要的感念，開發(fā)人員能夠非常容易的在Views和Controllers之間傳輸數(shù)據(jù)，在這節(jié)文章中，我們通過例子來了解模型綁定原理
                                        源代碼地址
                                        https://github.com/bingbing-gui/Asp.Net-Core-Skill/tree/master/Fundamentals/AspNetCore.ModelBinding/AspNetCore.ModelBinding

                                        參考文獻

                                        https://www.yogihosting.com/aspnet-core-model-binding/