.NET项目迁移到.NET Core操作指南

2019 年 6 月 11 日 DotNet

（给DotNet加星标，提升.Net技能）

转自：滴答的雨

cnblogs.com/heyuquan/p

前言

这篇文章，汇集了大量优秀作者写的关于".NET迁移到.NET Core"资料文章以及微软官方教程文档。是我在迁移公司框架项目到.NET Core和.NET Standard时遇到的问题，并将相关资料整理成这篇文章。记录如何一步一步把项目迁移到.NET Core。

为什么要从.NET迁移到.NET Core？

.NET Core 提供的特性

1、开源、免费

2、轻量级、跨平台

3、组件化、模块化、IOC+Nuget、中间件

4、高性能

5、统一了MVC和WebAPI编程模型

比如：ASP.NET Core 中MVC 和Web API 继承同一个基类，提供可使用的API也一致化
比如：旧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 Core 2.0性能飙升？

《.NET Core 3中的性能提升》

Java(11,12) 与 .NET Core(2.2,3.0)的性能对比测试

.NET如何迁移到.NET Core？

迁移工作量评估（API兼容性分析）

1、度量.NET Framework 迁移到.NET Core的工作量http://www.cnblogs.com/vveiliang/p/7402409.html

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

https://github.com/Microsoft/dotnet-apiport

3、【Cli 版本】https://github.com/Microsoft/dotnet-apiport/tree/dev/docs/Console

【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包中定义（第一次查询比较慢）

2、查询 NET API 在各版本中实现

结果图如下：

类库项目、应用项目如何选择框架类型

1、如何组织一个同时面向多目标框架的 C# 项目解决方案

2、.NetStandard;.netCore;FX(.NetFrameWork)之间引用关系

在 .NET Standard 2.0中，我们使在 .NET Standard 库中通过一个兼容层去引用已有的 .NET Framework 的库成为可能。当然，这只对那些只使用了适用于 .NET Standard API 的 .NET Framework 库有效。

FX引用.Net Core:不通过

.NetStandard引用.NetCore:不通过

.NetCore引用FX:通过

.NetCore引用.NetStandard:通过

.NetStandard引用FX:通过

FX引用.NetStandard:通过

具体参见：

【译】介绍 .NET Standard 【原文】
关于.NET Core 和 .NET fx相互引用的问题
.NET Standard;.NET Core;FX(.NET FrameWork)之间引用关系

3、项目支持多目标框架

支持多目标框架，并解决第三方库引用差异的问题（在 csproj 文件中指定包含条件）

目标框架名称列表（命名全小写）

如何调试多目标框架类库？

NET Standard/Core项目使用条件判断输出多版本xml注释文档

4、多目标框架中共享代码方案

【首选】.NET Standard，需要目标SDK支持对应的 .NET Standard 版本。
共享项目。直接共享了源码，只要在目标项目中指定了条件编译符，那么源码便能针对各种不同的目标框架进行分别编译。
[add as link]使用链接共享 Visual Studio 中的代码文件

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指令文档
如何将条件编译符号(DefineConstants)传递给msbuild

迁移到.NET Core，但只运行在windows平台上

使用 Windows 兼容性包将代码移植到 .NET Core
如何：将 Windows 窗体桌面应用程序移植到 .NET Core
如何：将 WPF 桌面应用移植到 .NET Core

兼容.NET Core或.NET Standard API

迁移HttpHandler与HttpModule到 ASP.NET Core 中间件

.NET CORE 2.0 踩坑记录之ConfigurationManager

.NET Core/Standard 2.0 编译时报“CS0579: Duplicate 'AssemblyFileVersionAttribute' attribute”错误

1、自动生成AssemblyInfo的原理

2、解决方案：不自动创建 AssemblyInfo 文件

ASP.NET Core开发之HttpContext
.NET core 使用JsonConvert替代JavaScriptSerializer
ASP.NET Core 中重复读取 Request.Body 的正确姿势

JsonRequestBehavior在core中被移除的问题

1、[ASP.NET MVC]解决"若要允许 GET请求，请将 JsonRequestBehavior 设置为AllowGet"

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）

为什么我的会话状态在ASP.NET Core中不工作了？

由于ASP.NET Core 2.1中引入的Cookie同意和非必要cookie的GDPR功能引起。（GDPR，即General Data Protection Regulation，《通用数据保护条例》）

在ASP.NET4.5和ASP.NET Core中共享cookies认证信息（加解密方式不一致问题）

https://www.cnblogs.com/cmt/p/5940796.html
https://github.com/blowdart/idunno.CookieSharing
ASP.NET Core如何获取客户端IP地址（被移除的ServerVariables对象）http://www.cnblogs.com/dudu/p/5972649.html

在ASP.NET Core中 BuildManager.GetReferencedAssembiles() 的替代方案

1、AppDomain.CurrentDomain.GetAssemblies()

2、https://stackoverflow.com/questions/53989393/is-there-an-alternative-for-buildmanager-getreferencedassemblies-in-asp-net-co（可以正常注入使用，但是调试时会报FileNotFoundException）