ASP.NET MVC应用迁移到ASP.NET Core及其异同简介
ASP.NET Core是微軟新推出支持跨平臺、高性能、開源的開發框架，相比起原有的ASP.NET來說，ASP.NET Core更適合開發現代應用程序，如跨平臺、Dorker的支持、集成現代前端開發框架(如npm、bower、gulp等等)。另外相比ASP.NET它的性能更好，還內置了依賴注入等功能對開發方式進行了優化。但它們之間也有很多相同或相似的地方，如都使用C#進行開發、都提供了MVC、Entity Framework、Identity等組件來快速構建應用程序。
本文將通過遷移一個簡單的ASP.NET應用為例，來介紹ASP.NET與ASP.NET Core之間的異同，其主要內容有：
●?.Net Core & ASP.NET Core & .Net Standard
●?ASP.NET應用遷移分析
●?類庫項目遷移
○?通過創建新項目完成類庫遷移
○?遷移EntityFramework
●?遷移ASP.NET MVC
○?創建一個新的ASP.NET Core MVC項目
○?路由遷移
○?過濾器遷移
○?依賴注入遷移
○?Web靜態資源及View遷移
●?小結
注：本文使用的VS2017為15.6.4版本，.Net Core SDK版本為2.1.103。
.Net Core & ASP.NET Core & .Net Standard
在介紹如何遷移ASP.NET應用之前，先了解一下新框架.Net Core和ASP.NET Core，.Net Core是一個全新開發平臺，新的運行時、SDK、類庫、工具(編譯工具、項目模板生成工具等等)，而ASP.NET Core則是基于.Net Core的一個Web應用開發框架，它們的關系實際上與.Net Framework和ASP.NET是一樣的。
但是在使用.Net開發的時候出現了一個新的名詞.Net Standard，.Net Standard是一個可用于所有.Net程序的API標準，換句話說就是如果使用.Net開發的API(類庫)符合.Net Standard，那么該類庫將可以用于所有的.Net應用。如下表所示，如果開發的類庫是以.Net Standard2.0標準開發的，那么該類庫將可應用到.Net Core2.0、.Net Framework4.6.1(需要.NET Core2.0的SDK支持)、Mono5.4、Xamarin、UWP等平臺的應用上。
更多關于.Net Standard的內容可參考文檔：https://docs.microsoft.com/en-us/dotnet/standard/net-standard
ASP.NET應用遷移分析
.Net Core雖然是一個全新的開發平臺（新運行時、新SDK、新類庫、新工具），但是它畢竟是以.Net Framework為基礎，所以對于部分API來說它仍然是參照且兼容.Net Framework的，所以在遷移.Net Core應用時可以先對代碼進行分析。
1、使用工具分析代碼：
有一個名為.Net Portability Analyzer的工具專門用于分析代碼和引用程序集在.Net不同平臺上的支持情況，該工具可以在VS的拓展管理中搜索并安裝，或者到頁面上下載VS插件雙擊安裝(https://marketplace.visualstudio.com/items?itemName=ConnieYau.NETPortabilityAnalyzer)：
安裝完成后在VS的解決方案窗口中右鍵解決方案或者項目就可以看到下圖兩個菜單項，分別用于分析程序集的可移植性和對移植分析器的配置：
移植分析器的配置主要是對目標平臺和報表輸出類型進行配置：
下圖是對My Blog應用進行可移植性分析的Excel報表(部分)：
可移植性總結：
問題細節：
缺失的程序集：
注：沒找到更多關于缺少程序集的解釋，不確定是無法解析還是無兼容性，本文暫時將這些程序集理解為僅支持.Net Framework平臺。
從分析報告中可以看出，除了MVC項目，其它類庫項目與.Net Core或者.Net standard標準的兼容程度均為100%。
2、根據實際情況對項目引用進行分析：
工具對代碼的分析僅可參考，畢竟使用.Net Framework開發的應用可能引用了很多第三方類庫，這些類庫可能不支持其它平臺，有些類庫可能支持，但是對于原有版本有了很多Break Changes，使用方法與原先不一致了，所以在進行代碼遷移之前對項目引用進行分析，從技術上分析代碼遷移是否可行。
本例中倉儲的實現依賴了Entity Framework、EF MySQL、Autofac、Identity等組件，這些組件在.Net Core下也是有相應實現，雖然API會有改動，但技術上是沒有問題的可以遷移。接下來就開始介紹如何完成遷移。
類庫項目遷移
現在.Net Core項目與.Net Framework項目一樣都是使用MSBuild格式的csproj文件來管理項目的相關屬性，如名稱、版本號、包依賴、項目依賴等等，所以實際上項目的遷移最大的改動就是將csproj的內容改為.Net Core的即可(.Net Core的csproj文件詳情參考文檔：https://docs.microsoft.com/en-us/dotnet/core/tools/csproj)，改動csproj文件有兩種方法，如果熟悉文件格式，那么直接改動原有文件即可，如果不熟悉那么可以通過重新創建項目的方式，讓VS來完成創建/修改工作。
通過創建新項目完成類庫遷移
本文將通過重新創建項目的方式來完成項目遷移，以保證csproj配置文件的正確性。
首先通過VS創建一個.Net Standard的類庫項目：
然后把相應的代碼復制到新建項目的目錄下，刪除不存在的命名空間即可。
注：.Net Core會自動識別項目目錄下的代碼文件，而原來的.Net Fx項目需要在csporj文件中引入，所以這里直接復制代碼文件即可識別到項目中。
遷移EntityFramework
本例程序中用于實現倉儲的類庫依賴了EF，而實現MySQL EF的類庫還依賴了My SQL的EF相關組件。
另外隨著.Net Core的推出，EF也推出了EFCore，另外新版本的.Net大量引入了Options模式來對程序進行配置，關于Options模式可參考文檔：https://docs.microsoft.com/en-us/aspnet/core/fundamentals/configuration/options?view=aspnetcore-2.1
中文文檔：https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/configuration/?tabs=basicconfiguration
所以在遷移EF的時候，除了創建新的項目，還需要安裝新的Nuget包并且修改相應的配置代碼：
1. 安裝EFCore組件：
安裝Microsoft.EntityFrameworkCore：
2.處理EFCore的配置：
EFCore配置文檔：https://docs.microsoft.com/zh-cn/ef/core/miscellaneous/configuring-dbcontext
注：EFCore針對不同數據庫的配置信息通過DbContextOptions對象完成，所以構造方法不再是一個簡單的連接字符串，另外EFCore提供了針對ASP.NET Core容器的依賴注入方法，為了利用依賴注入可以把DbContext配置交由ASP.NET Core項目完成，包括對不同數據源的支持。
通過上面的方法即可把例子中的類庫項目完成遷移，接下來進行MVC項目的遷移工作。
遷移ASP.NET MVC
ASP.NET Core是一項變革，除了跨平臺之外，它還改變了原先ASP.NET的思想和開發方式，如MVC及API的Controller合二為一、擁抱現代前端開發方式方法、Dorcker支持等，接下來將通過介紹其遷移過程來了解ASP.NET與ASP.NET Core的異同。
創建一個新的ASP.NET Core MVC項目
相對與類庫來說MVC項目的遷移要復雜的多，因為新的ASP.NET在項目文件結構、程序啟動、開發方式等方面都有了區別，這里仍然使用創建新項目的方式完成ASP.NET MVC應用的遷移：
創建一個ASP.NET Core MVC應用：
下面是新項目的目錄結構：
ASP.NET Core MVC與原先ASP.NET MVC類似核心仍然是Controllers、Models、Views三個目錄，另外通過wwwroot目錄對HTML資源進行了整合、配置文件變更為Json格式、刪除了Global.asax取而代之的是Program.cs和Startup.cs文件。
ASP.NET開發的Web應用程序需要IIS作為宿主才可以運行，而ASP.NET Core作為一種可跨平臺的Web應用開發框架其應用必定是與IIS完全解耦的，所以它的啟動方式也完全不一樣。
ASP.NET Core中引入了Program類型，如Console應用一樣通過Main方法來運行程序，而ASP.NET Core的Main方法主要內容是指明一個Startup類型完成Web服務器的創建。而Startup類型則負責了整個應用的配置和HTTP請求管道搭建的任務，所以首先要完成的工作就是將原先Global及Owin Startup文件中的內容移植到Startup文件中，下面就開始詳細介紹ASP.NET Core MVC的變化及遷移方法。
MVC除了包含Controller、Model、View等文件外，還需要進行路由、過濾器等功能配置，所以首先需要將原項目的相關文件(controller、model、view等注：因為原項目和ASP.NET Core的MVC都依賴Identity實現用戶管理功能，所以涉及到用戶管理的部分不需要復制)復制到新項目中，修改命名空間引用如：System.Web.Mvc->Microsoft.AspNetCore.Mvc并修復其它命名空間引用錯誤。
接下來完成其它幾個重要方面的遷移。
路由遷移
將原有的路由配置包含Area的路由配置轉移至Startup類型的Configure方法中：
注：本例存在Controller名稱重名情況，但ASP.NET Core MVC沒有提供如ASP.NET中通過命名空間區別的方式區別Controller重名，本例通過修改名稱解決問題，如需命名空間區分Controller可參考：https://stackoverflow.com/questions/34306891/restrict-route-to-controller-namespace-in-asp-net-core
過濾器遷移
全局過濾器的配置則是由原來的通過FilterConfig對象注冊改為Startup的ConfigureServices方法中對MVC進行配置：
依賴注入遷移
ASP.NET Core內置了依賴注入功能，甚至一些組件都提供了專門的拓展方法將其服務添加到容器中，如EFCore、Identity、MVC。
上圖為ASP.NET Core默認的為將DbContext、Identity以及MVC相關服務添加到容器的代碼，除此之外為了順應依賴注入思想，這里將原有代碼的倉儲和服務類型均注冊到容器中，其依賴通過構造方法進行注入。
倉儲代碼：
業務代碼：
控制器代碼：
服務注冊代碼：
注：本例中實現依賴的是實現而非抽象，這不符合依賴倒置原則，所以此處僅作為ASP.NET Core依賴注入使用示例。另外為了讓EFCore支持MySQL，所以需要在項目中添加Pomelo.EntityFrameworkCore.MySql組件：
Web靜態資源及View遷移
ASP.NET的頁面是基于HTML實現的，一個ASP.NET的頁面除了HTML代碼外還會引用一些外部靜態資源，如css、js、image、font等內容，而ASP.NET中專門提供了Bundle技術來管理這些資源（可參考：《ASP.NET沒有魔法——ASP.NET MVC界面美化及使用Bundle完成靜態資源管理》），那么ASP.NET Core是如何管理這些資源的呢？
首先要處理ASP.NET Core中靜態文件的訪問問題，在ASP.NET中由于它依賴IIS，而靜態文件訪問已經被IIS處理了，所以程序中無需關心，但ASP.NET Core不一樣，需要在其請求管道中添加相應的處理中間件：
注：ASP.NET Core項目模板默認添加該中間件。
對于靜態資源的管理ASP.NET Core通過bundleconfig.json配置文件進行配置取代了原先的BundleConfig類型。把原先的資源文件復制到ASP.NET Core的wwwroot目錄下，然后在bundleconfig.json文件下進行配置，如下圖(部分)：
?
完成配置后還需要在項目中添加一個BuildBundlerMinifier的組件：
引入BuildBundlerMinifier后編譯項目就會觸發資源綁定和最小化操作：
注：和ASP.NET不同，Core里面的靜態資源管理是在編譯過程中處理的，并且通過一個json配置文件完成處理定義，除了BuildBundlerMinifier外還可以使用Gulp等工具完成資源的優化，關于Gulp的使用可參考：https://docs.microsoft.com/en-us/aspnet/core/client-side/bundling-and-minification?view=aspnetcore-2.0&tabs=visual-studio%2Caspnetcore2x#consume-bundleconfigjson-from-gulp
完成靜態資源遷移后因為Bundle機制的改變還需要對View中資源引用進行修改(ASP.NET Core中不再提供@Scripts和@Styles類型來渲染樣式和腳本引用)：
運行結果：
小結
.Net Core是一個新的開發框架，2.0版本的.Net Core已經相對完善，本文介紹了一個簡單的ASP.NET MVC遷移至.Net Core的例子，從例子中可以看出新的開發平臺已經實現了原有的所有功能和解決方案，甚至在原有基礎上進行了改進。另外.Net Core作為新框架它是開源的并且相對于.Net Framework來說它的文檔更全面(中文文檔相對落后)，所以.Net Core更容易學習和使用。
對于遷移來說，首先還是看需求和目的，為什么要進行遷移？為了容器化？跨平臺部署？在真實項目中遷移一個項目是非常復雜且具有風險的，所以如果要進行遷移需要慎重考慮，考慮遷移是否是最好的解決方案?！ ?/p>
參考：
http://crbtech.in/Dot-Net-Training/9-things-know-converting-asp-dot-net-to-dot-net-core/
https://docs.microsoft.com/en-us/dotnet/core/tools/project-json-to-csproj
https://docs.microsoft.com/en-us/aspnet/core/fundamentals/configuration/options?view=aspnetcore-2.1
https://docs.microsoft.com/en-us/aspnet/core/client-side/bundling-and-minification?view=aspnetcore-2.1&tabs=visual-studio%2Caspnetcore2x
https://stackoverflow.com/questions/34306891/restrict-route-to-controller-namespace-in-asp-net-core
https://docs.microsoft.com/en-us/aspnet/core/migration/proper-to-2x/?view=aspnetcore-2.1
原文地址?：http://www.cnblogs.com/selimsong/p/8870286.html?
.NET社區新聞，深度好文，歡迎訪問公眾號文章匯總 http://www.csharpkit.com
總結
以上是生活随笔為你收集整理的ASP.NET MVC应用迁移到ASP.NET Core及其异同简介的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： ASP.NET Core 2.0 : 图
- 下一篇： .NET Core Community