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。
在介紹如何遷移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
.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檔案中引入，是以這裡直接複制代碼檔案即可識别到項目中。
本例程式中用于實作倉儲的類庫依賴了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 Core是一項變革，除了跨平台之外，它還改變了原先ASP.NET的思想和開發方式，如MVC及API的Controller合二為一、擁抱現代前端開發方式方法、Dorcker支援等，接下來将通過介紹其遷移過程來了解ASP.NET與ASP.NET Core的異同。
相對與類庫來說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元件：
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更容易學習和使用。
對于遷移來說，首先還是看需求和目的，為什麼要進行遷移？為了容器化？跨平台部署？在真實項目中遷移一個項目是非常複雜且具有風險的，是以如果要進行遷移需要慎重考慮，考慮遷移是否是最好的解決方案。
參考：
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
作者：7m魚
出處：http://www.cnblogs.com/selimsong/
本文版權歸作者和部落格園共有，歡迎轉載，但未經作者同意必須保留此段聲明，且在文章頁面明顯位置給出原文連接配接，否則保留追究法律責任的權利。