如何將.NET項目遷移到.NET Core

来源:https://www.cnblogs.com/88223100/archive/2022/04/19/How_to_migrate_NET_projects_to_NET_Core.html
-Advertisement-
Play Games

很多.net項目在開發的時候，.net core還沒有出現或者還麽有成熟，如今.netcore3.1已經出現，其技術風險已經比較低，今天對項目如何遷移到.net core做一個簡單的梳理，瑾做參考。 ...


很多.net項目在開發的時候，.net core還沒有出現或者還麽有成熟，如今.netcore3.1已經出現，其技術風險已經比較低，今天對項目如何遷移到.net core做一個簡單的梳理，瑾做參考。

為什麼要從.NET遷移到.NET Core？

.NET Core提供的特性

1.免費和最寬鬆的開源協議

.NET Core從屬於.NET基金會，由微軟進行官方支持。使用最寬鬆的MIT和Apache 2開源協議，文檔協議遵循CC-BY。這將允許任何人任何組織和企業任意處置，包括使用，複製，修改，合併，發表，分發，再授權，或者銷售。唯一的限制是，軟體中必須包含上述版權和許可提示，後者協議將會除了為用戶提供版權許可之外，還有專利許可，並且授權是免費，無排他性的(任何個人和企業都能獲得授權)並且永久不可撤銷，用戶使用.NET Core完全不用擔心收費問題，你可以很自由的部署在任何地方.

2.輕量級、跨平臺

3.組件化、模塊化、IOC+Nuget、中間件

4.高性能

5.統一了MVC和WebAPI編程模型

a) 比如：ASP.NET Core 中MVC 和Web API 直接或間接繼承同一個基類 ControllerBase，提供可使用的API也一致化

b) 比如：舊ASP.NET時代，寫全局filter需要針對MVC 和Web API 分別編寫代碼，但在ASP.NET Core，直接使用一套中間件代碼即可

6.可測試性

7.微服務、容器化支持

8.標準化 .NET API 規範- .NET STANDARD，整體架構如下圖：

 

 

.NET Core性能提升

1.TechEmpower機構

  TechEmpower機構會定期對各語言主流的web框架做性能測試

  地址：https://www.techempower.com/benchmarks/

 

2.博客園博主、微軟MVP – 楊曉東，做的 “Hello World”性能測試

ASP.NET Core 1.1性能對比評測（ASP.NET，Python，Java，NodeJS）

地址：https://www.cnblogs.com/savorboard/archive/2016/10/17/dotnet-benchmarks.html

 

 

 

 

性能測試工具：

微軟出品：Benchmarks

地址：https://github.com/aspnet/benchmarks

.NET如何遷移到.NET Core？

遷移工作量評估（API相容性分析）

度量.net framework 遷移到.net core的工作量

地址：https://www.cnblogs.com/vveiliang/p/7402409.html

可移植性分析工具：.NET Portability Analyzer

地址：https://github.com/Microsoft/dotnet-apiport

【Cli 版本】 【Visual Studio Extension 版本】

地址：https://github.com/Microsoft/dotnet-apiport/tree/dev/docs/VSExtension

評估會給出類似如下報告：

 

 

.NET Standard Versions

地址：https://github.com/dotnet/standard/blob/master/docs/versions.md

 

 

遷移方案制定

微軟官方《組織項目以支持 .NET Framework 和 .NET Core》文章中，有介紹兩種遷移方案：

方案一、將現有項目和 .NET Core 項目合併為單個項目（多目標框架）

方案二、將現有項目和新的 .NET Core 項目分離（拷貝到新項目）

通過類名、命名空間，查詢API的實現信息

遷移過程中，有類庫命名空間被調整，nuget歸屬包被調整，具體類庫在.NET Core哪個版本中被實現也不是很清楚，通過下麵兩個查詢助手，即可解決這些問題。

1、查詢命名空間、類庫在哪個nuget package包中定義（第一次查詢比較慢）

地址：https://packagesearch.azurewebsites.net/

2、查詢 NET API 在各版本中實現

地址：https://apisof.net/catalog/

結果圖如下：

 

 

 

 類庫項目、應用項目如何選擇框架類型

1.如何組織一個同時面向多目標框架的 C# 項目解決方案

地址：https://walterlv.com/post/organize-csharp-project-targeting-multiple-platforms.html

2..NetStandard;.netCore;FX(.NetFrameWork)之間引用關係

在 .NET Standard 2.0中，我們使在 .NET Standard 庫中通過一個相容層去引用已有的 .NET Framework 的庫成為可能。當然，這隻對那些只使用了適用於 .NET Standard API 的 .NET Framework 庫有效。

 

 

FX引用.NetCore:不通過

.NetStandard引用.NetCore:不通過

.NetCore引用FX:通過

.NetCore引用.NetStandard:通過

.NetStandard引用FX:通過

FX引用.NetStandard:通過

ASP.NET Core可以在“.NET Framework 和 .NET Core”上運行，但ASP.NET Core 3.0 以及更高版本只能在 .NET Core 中運行。

具體參見：

【譯】介紹 .NET Standard

地址：https://www.cnblogs.com/jinanxiaolaohu/p/10681024.html

關於.net core 和 .net fx相互引用的問題

地址：https://q.cnblogs.com/q/103398/

.NetStandard;.netCore;FX(.NetFrameWork)之間引用關係

地址：https://www.cnblogs.com/xiaoliangge/p/7475268.html

3.項目支持多目標框架

支持多目標框架，並解決第三方庫引用差異的問題（在 csproj 文件中指定包含條件）

地址：https://walterlv.com/post/configure-projects-to-target-multiple-platforms.html

目標框架名稱列表 （命名全小寫）

地址：https://docs.microsoft.com/zh-cn/nuget/reference/target-frameworks

如何調試多目標框架類庫？

地址：https://docs.microsoft.com/zh-cn/nuget/reference/target-frameworks

NET Standard/Core項目使用條件判斷輸出多版本xml註釋文檔

地址：https://blog.csdn.net/starfd/article/details/78839704

 

 

4.多目標框架中共用代碼方案

1、【首選】.NET Standard，需要目標SDK支持對應的 .NET Standard 版本。

2、共用項目。直接共用了源碼，只要在目標項目中指定了條件編譯符，那麼源碼便能針對各種不同的目標框架進行分別編譯。

3、[add as link]使用鏈接共用 Visual Studio 中的代碼文件

地址：https://blog.csdn.net/starfd/article/details/78839704

5.條件編譯符號 （命名全大寫）

指令：#if #elif #else #endif （||、&&、!）

因為目標框架提供的API不相同。故必要時可添加條件編譯符號以便支持不同的運行時版本。

微軟有針對各個目標框架有預定義預處理器符號，vs編譯時會自動識別到這些框架條件編譯符號。

.NET Framework 4.5 --> NET45

.NET Framework 4.6 --> NET46

.NET Framework 4.6.1 --> NET461

.NET Standard 1.0 --> NETSTANDARD1_0

.NET Standard 1.6 --> NETSTANDARD1_6

.NETCOREAPP 2.0 --> NETCOREAPP2_0

參考：

#if指令文檔

地址：https://blog.csdn.net/starfd/article/details/78839704

如何將條件編譯符號(DefineConstants)傳遞給msbuild

地址：http://www.voidcn.com/article/p-nsrcccet-btr.html

遷移到.NET Core，但只運行在windows平臺上

使用 Windows 相容性包將代碼移植到 .NET Core

地址：https://docs.microsoft.com/zh-cn/dotnet/core/porting/windows-compat-pack

如何：將 Windows 窗體桌面應用程式移植到 .NET Core

地址：https://docs.microsoft.com/zh-cn/dotnet/core/porting/winforms

如何：將 WPF 桌面應用移植到 .NET Core

地址：https://docs.microsoft.com/zh-cn/dotnet/core/porting/wpf

相容.NET Core或.NET Standard API

遷移HttpHandler與HttpModule到 ASP.NET Core 中間件

地址：https://docs.microsoft.com/en-us/aspnet/core/migration/http-modules?view=aspnetcore-2.2

.NET CORE 2.0 踩坑記錄之ConfigurationManager

地址：https://www.cnblogs.com/binbinxu/p/7440342.html

.NET Core/Standard 2.0 編譯時報“CS0579: Duplicate 'AssemblyFileVersionAttribute' attribute”錯誤

1.自動生成AssemblyInfo的原理

地址：https://www.cnblogs.com/binbinxu/p/7440342.html

2.解決方案：不自動創建 AssemblyInfo 文件

地址：https://cloud.tencent.com/developer/article/1402303

ASP.NET Core開發之HttpContext

地址：https://www.cnblogs.com/linezero/p/6801602.html

.net core 使用JsonConvert替代JavaScriptSerializer

地址：https://my.oschina.net/idoop/blog/915555

ASP.NET Core 中重覆讀取 Request.Body 的正確姿勢

地址：http://www.cnblogs.com/dudu/p/9190747.html

JsonRequestBehavior在core中被移除的問題

1.[ASP.NET MVC]解決"若要允許 GET請求，請將 JsonRequestBehavior 設置為AllowGet"

地址：https://shiyousan.com/post/635428880708292949

2.[ASP.NET Core]core中不會拋出AllowGet異常，對於DenyGet則使用[HttpPost]代替

地址：

https://stackoverflow.com/questions/38578463/asp-net-core-the-name-jsonrequestbehavior-does-not-exist-in-the-current-cont

 

https://stackoverflow.com/questions/8464677/why-is-jsonrequestbehavior-needed?r=SearchResults

獲取ASP.NET Core中的Web根路徑和內容根路徑（移除的MapPath）

地址：http://beidouxun.com/Articles/Details/419f4786-679c-4316-b2bb-baea26c94205

為什麼我的會話狀態在ASP.NET Core中不工作了？

地址：https://www.cnblogs.com/lwqlun/p/10526380.html

由於ASP.NET Core 2.1中引入的Cookie同意和非必要cookie的GDPR功能引起。（GDPR，即General Data Protection Regulation，《通用數據保護條例》）

在ASP.NET4.5和ASP.NET Core中共用cookies認證信息（加解密方式不一致問題）

.NET跨平臺之旅：ASP.NET Core從傳統ASP.NET的Cookie中讀取用戶登錄信息

地址：https://www.cnblogs.com/cmt/p/5940796.html

開源方案：[git]idunno.CookieSharing

地址：https://github.com/blowdart/idunno.CookieSharing

ASP.NET Core如何獲取客戶端IP地址（被移除的ServerVariables對象）

地址：https://www.cnblogs.com/dudu/p/5972649.html

如何獲取項目依賴的所有程式集

方案一：AppDomain.CurrentDomain.GetAssemblies()，此辦法不能獲取到所有依賴的程式集，因為.Net有延遲載入程式集機制

方案二：適用於傳統ASP.NET項目，System.Web.Compilation.BuildManager.GetReferencedAssemblies();

方案三：適用於ASP.NET Core項目，DependencyContext.Default.CompileLibraries，具體代碼參考下麵

 

 

參考：

AppDomain.CurrentDomain.GetAssemblies()

地址：https://www.cnblogs.com/beixing/p/3803874.html

Is there an alternative for BuildManager.GetReferencedAssemblies() in ASP.NET Core?

地址：https://stackoverflow.com/questions/53989393/is-there-an-alternative-for-buildmanager-getreferencedassemblies-in-asp-net-co

.NET Core 2.0遷移System.Runtime.Caching

地址：https://www.cnblogs.com/mantgh/p/7429551.html

.NET Core 2.0升級到3.0實戰方案

地址：https://www.cnblogs.com/laozhang-is-phi/p/11520048.html

從.NET CORE2.2升級到3.0過程及遇到的一些問題

地址：https://www.cnblogs.com/roadflow/p/11711686.html

遷移EF框架

【微軟官方】從 EF6 到 EF Core的遷移系列

地址：https://www.cnblogs.com/roadflow/p/11711686.html

【微軟官方】EF Core 版本升級遷移系列

地址：https://docs.microsoft.com/zh-cn/ef/core/what-is-new/ef-core-2.2

修改為 ASP.NET Core 風格的應用

按照上面的方式修改API相容性後，框架類庫可以順利遷移到.NET Core，編譯通過，代碼運行也正常。但是ASP.NET Core風格的應用，其寫法也是有很多變化的。具體參考下麵文檔：

將傳統 ASP.NET 應用遷移到 .NET Core

地址：https://mp.weixin.qq.com/s?__biz=MzAwNTMxMzg1MA==&mid=2654072516&idx=3&sn=af3916ec4e2c31c231f5f01be75712d8&chksm=80dbca91b7ac43870a3fa4dce10f5a97adf1548d1381a99f27972c67c00a1e593aa926b110ad&mpshare=1&scene=23&srcid=0311kxbJ5rwkIYu7xO2Yx08U

【微軟官方】ASP.NET 遷移到 ASP.NET Core教程系列

地址：https://docs.microsoft.com/zh-cn/aspnet/core/migration/proper-to-2x/?view=aspnetcore-2.2

【微軟官方】ASP.NET Core 版本升級遷移系列

地址：https://docs.microsoft.com/zh-cn/aspnet/core/migration/20_21?view=aspnetcore-2.2

相關文章：

.NET Core 3中的性能提升（譯文）

地址：https://zhuanlan.zhihu.com/p/66152703

Java(11,12) 與 .NET Core(2.2,3.0)的性能對比測試

地址：https://blog.csdn.net/hez2010/article/details/86551299

載自：cnblog.windy

 

本文來自博客園，作者：古道輕風，轉載請註明原文鏈接：https://www.cnblogs.com/88223100/p/How_to_migrate_NET_projects_to_NET_Core.html


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • BigDecimal 設置小數位數、小數比例轉換整數
    控制小數位數 控制數值變大變小 數字轉漢字格式 引入 cn.hutool.core.convert 包 ...
  • 如何用 Python 識別車牌
    車牌識別在高速公路中有著廣泛的應用，比如我們常見的電子收費（ETC）系統和交通違章車輛的檢測，除此之外像小區或地下 車庫門禁也會用到，基本上凡是需要對車輛進行身份檢測的地方都會用到。 簡介 車牌識別系統（Vehicle License Plate Recognition）是電腦視頻圖像識別技術在車 ...
  • Pillow 圖片處理模塊
    Pillow 圖片處理模塊 Pillow是Python第三方庫，Python2中有一個叫PIL(Python Imaging Library)的標準庫，但不支持Python3，所以一些志願者在PIL的基礎上創建了Pillow，支持Python3。Pillow支持動態圖像編輯。 安裝Pillow pi ...
  • 甲骨文嚴查Java授權，換openJDK要避坑
    背景 外媒The Register報道，甲骨文稽查企業用戶，近期開始將把過去看管較鬆散的Java授權加入。 甲骨文針對標準版Java（Java SE）有2種商業授權。2019年4月甲骨文宣佈Java SE用戶需要付費訂閱，才能取得授權及更新，包括Java SE 7、8或11、12。但到同年9月該公司 ...
  • 字元集與編碼
    一個比特(bit)可以是0，或者是1，8個比特(bit)，組成一個位元組(byte)。全為0時代表數字0，全為1時代表數字255。 一個位元組可以表示256個數字，兩個位元組可以表示65536個數字。 更多的位元組，可以有更多的組合，就可以表示更大的數值範圍。 整數可以這麼存，那字元呢？一堆二進位的0和1， ...
  • Python暴力破解附近區域網WiFi密碼
    前言 本文將記錄學習下如何通過 Python 腳本實現 WIFI 密碼的暴力破解，從而實現免費蹭網。 無圖形界面 先來看看沒有圖形界面版的爆破腳本。 WIFI爆破 Python學習交流Q群：906715085#### import pywifi from pywifi import const im ...
  • 關於c++中的const的總結
    1.為什麼要用const const本質上其實不僅僅是對變數的一個限定符，更是對程式員的一個限定符，它提醒了程式員，通過const限定的變數的值是不應該被更改的，並且當編譯器得知變數或者表達式的求值結果是恆定的時候，編譯器也可以在編譯期大展拳腳，為我們做出一些編譯期優化，進而提高我們的程式在運行時的 ...
  • 全自動設備管理系統CNC管理系統機床管理系統CNC設備點檢系統CNC機床設備報修系統機床報修系統
    介紹 Dapr簡化了雲原生開發，讓開發可以把焦點放在應用的業務邏輯上，從而讓代碼簡單、可移植，那作為一個.Net開發者，我們也希望項目可以快速用上dapr，那究竟應該如何做呢？ Dapr提出了Sidecar(邊車)的概念，在啟動項目時再額外啟動一個Sidecar, 通過Sidecar可以解決進程間通 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類