.NET Core 学习资料精选：入门

开源跨平台的.NET Core，还没上车的赶紧的，来不及解释了……

本系列文章，主要分享一些.NET Core比较优秀的社区资料和微软官方资料。我进行了知识点归类，让大家可以更清晰的学习.NET Core。

首先感谢资料原作者的贡献。

第一篇：.NET Core 学习资料精选：入门

介绍.NET历史、开源之路、基础、路由、依赖注入DI、HttpContext、cookie|session、HttpClient、gRPC、单元测试、发布部署等等。

第二篇：.NET Core 学习资料精选：进阶

介绍.NET工程化、AOP、异常处理、缓存、日志、响应优化、上传下载、健康检查、后台任务、认证和授权、安全性（Https、CORS、CSRF）、EF Core 等等

第三篇：.NET Core 学习资料精选：高级&微服务架构

介绍性能、原理、微服务架构、Docker、DDD等知识

这是第一篇，知识点如图：

.NET 简介

#、.NET 开源之路

2014.11月 .NET Core 项目启动，2016.06月 .NET Core 1.0 发布

.NET Core 3.0 新特性：支持 Windows 桌面应用（windows only）

.NET Core 3.0 正式公布：新特性详细解读

.NET Core 3.0 下一个版本命名为：.NET 5

【翻译】.NET Core3.1发布（及各版本支持时长）

.NET Core Roadmap

[翻译] .NET 官宣跨平台 UI 框架 MAUI (.NET 6)

#、.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

目前市面上还存在很多传统 .NET 旧项目，我们需要根据公司情况决定是否升级到.NET Core。

如果需要进行旧项目升级的，可以参考文章：《.NET项目迁移到.NET Core操作指南》

VS和.NET Core安装

Vistual Studio

VS2019安装教学

VS2019正式版注册码秘钥

Visual Studio 中使用Libman管理客户端库

[坑]安装 .Net Core 2.2 SDK后，VS2017依然不能设置core2.2为目标框架

把.net Core 项目迁移到VS2019 for MAC（无需改一行代码）

调试

VS2019自带反编译与 Reflector 反编译工具比较

使用dnSpy调试asp.net core源码

Visual Studio 2017中使用SourceLink调试Nuget包源码（SourceLink方式）

Visual Studio 2017调试开源项目代码（下载源代码文件方式）

VS Code 开发.NET Core

使用VS Code 开发.NET CORE 程序指南

完整构建VSCode开发调试环境

.NET Core SDK

安装 .NET Core Runtime 和.NET Core SDK

如何为.NETCore安装汉化包智能感知

Linux/MacOS 安装 .NET Core SDK 命令

.NET Core 卸载工具 (dotnet-core-uninstall)

修改nuget包默认存放路径，避免C盘膨胀

【微软官方文档】ASP.NET Core *.* 个版本新特性

指定要使用的 .NET Core 版本

如何删除 .NET Core 过时的运行时和 SDK

基础

术语：

程序员需要知道的缩写和专业名词

后端开发术语大全

一文读懂QPS、TPS、PV、UV、GMV、IP、RPS

ASP.NET Core开发者路线指南

微软官方 asp.net core 教程文档（入口）

.NET Core 命令行接口 (CLI) 工具

.NET Core应用的三种部署方式

.NET Core RID 目录（参数：-r|--runtime）

.NET Core 目标框架（参数：-f|--framework）

dotnet publish 发布的文件中包含pdb文件，不论模式是Debug还是Release。可以通过配置：

<PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
      <DebugType>None</DebugType>
      <DebugSymbols>false</DebugSymbols>
      ……
</PropertyGroup>

--self-contained 自包含参数。将.NET Core运行时及.NET Core类库随应用一起打包，这样可以完全避免老项目在系统.NET Core运行时升级时，带来莫名异常的问题

.NET Core 运行程序注意事项（dotnet dll 与 dotnet run）

core api 支持情况

ASP.NET Core API 一览表

查询 NET API 及类库在各版本中实现情况

ASP.NET Core 项目目录结构介绍

ASP.NET Core 端口配置

NetCore 启动地址配置详解

Asp.Net Core WebAPI 端口修改（host.json）

Net Core3.0配置项目端口号

ASP.NET Core 中的Startup类

[视频]基于Webhost分析netcore启动原理

ASP.NET Core 中使用多个环境（开发、预发布、生产）- 默认为 Production

ASP.NET Core 返回类型ActionResult|ActionResult<T>|Dto

ASP.NET Core 动作结果（ActionResult）

ASP.NET Core 中控制器操作的多路径返回类型（IActionResult）

ASP.NET Core中的Action的返回值类型

.NET Core 3.0 新的 System.Text.Json API

配置

ASP.NET Core 中的配置（json、xml、命令行、环境变量、内存变量等）

ASP.NET Core 中的选项模式

ASP.NET Core 中IOptions、IOptionsMonitor以及IOptionsSnapshot

ASP.NET Core 为选项数据添加验证

.Net Core 自定义配置源从远程API读取配置（ConfigurationProvider）

迈向现代化的 .Net 配置指北（配置到类自动映射）

路由、模型绑定

ASP.NET Core WebAPI中，Controller标注 [ApiController] 特性，其路由只能使用[route]特性方式

ASP.NET Core MVC 构建可读性更高的ASP.NET Core 路由

ASP.NET Core 3.x 为什么采用新的 Endpoint Routing 路由系统

ASP.NET Core 3.0中使用动态控制器路由

ASP.NET Core 中的模型绑定

ASP.NET Core 中的自定义模型绑定（IModelBinder）

ASP.NET Core 中的 URL 重写中间件

ASP.NET Core API默认支持的InputFormatters：application/json-patch+json、application/json、text/json、application/*+json

ASP.NET Core API默认支持的OutputFormatters：text/plain、application/json、text/json、application/*+json

ASP.NET Core Web API 入参解析InputFormatter

ASP.NET Core Web API 对输入流stream的支持

ASP.Net Core Web Api中异步视频流的IOutputFormatter

控制反转、依赖注入

什么是控制反转，和依赖注入：

依赖倒置原则（Dependence inversion principle，DIP）：软件设计原则，要依赖于抽象，不要依赖具体实现。

控制反转（Inversion of Control，IoC）：IOC是一种实现DIP原则的模式。平常我们需要一个类对象的时候需要new出来，而现在我们把new一个类对象的工作交给了IOC容器，当我们需要一个类对象的时候直接向IOC容器要，就可以了，这个就是控制反转。（控制权交个了IOC容器）

依赖注入（Dependency Injection，DI）：DI是实现IOC的一种方式。当我需要一个类对象，IOC容器给我们这个类对象的过程其实就是依赖注入，依赖注入有构造函数注入和属性注入。

[官方]ASP.NET Core 依赖注入

全面理解 ASP.NET Core 依赖注入

官方推荐通过构造函数。这也是所谓的显式依赖。Asp.Net Core 的标准依赖注入容器不支持属性注入。（可以使用autofac或者其他来实现属性注入）

ASP.NET Core 中依赖注入的N种玩法

ASP.NET Core 自定义特性实现属性注入

ASP.NET Core 原生DI实现批量注册

可以参考 OSharp 框架，设计三个全局注入接口，来实现自动化注入：ISingletonDependency 和 ITransientDependency 、 IScopedDependency （单例、瞬时、范围）。

ASP.NET Core 中如何注入同一个接口的多个实现

案例1：使用nlog时，想根据需要使用不同的配置文件Nlog.config 写日志时，就可以使用文章中介绍的 Factory 命名注入方案来实现

案例2：使用分布式缓存 IDistributedCache 时，想根据需要在一个项目中同时使用redis和sqlserver

ASP.NET Core 中多个接口对应同一个实现的正确姿势

ASP.NET Core 依赖注入扩展库 Scrutor

[OSharp]使用 IServiceProvider.GetService<T>() 实现按需注入，优化性能

在WPF中使用.NET Core 3.0依赖项注入和服务提供程序

#、ASP.NET Core 结合 Autofac 的使用

AutoFac三种注入方式：按类型、按名称、按键

Asp.Net Core 2.0 之旅---AutoFacIOC容器的使用教程（批量注入）

Asp.Net Core 2.0 之旅---AutoFac仓储泛型的依赖注入（泛型注入）

Asp.Net Core 2.0 之旅---数据访问仓储模式的事务管理（uow+rp）

ASP.NET Core 技巧之伪属性注入(属性注入会造成类型的依赖关系隐藏，测试不友好等)

ASP.NET Core 中使用Autofac实现属性注入的代码片段

public IServiceProvider ConfigureServices(IServiceCollection services)
{
    // 第一步：替换系统默认Controller创建器（否则Controller下面无法使用属性注入）
    // 在 services.AddMvc() 之前
    services.Replace(ServiceDescriptor.Transient<IControllerActivator, ServiceBasedControllerActivator>());
    services.AddMvc();

    var builder = new ContainerBuilder();

    // 第二步：找到所有Controller的类型
    // 通过Autofac对Controller类型进行属性注册 PropertiesAutowired()
    var assembly = this.GetType().GetTypeInfo().Assembly;
    var manager = new ApplicationPartManager();
    manager.ApplicationParts.Add(new AssemblyPart(assembly));
    manager.FeatureProviders.Add(new ControllerFeatureProvider());
    var feature = new ControllerFeature();
    manager.PopulateFeature(feature);
    builder.RegisterTypes(feature.Controllers.Select(ti => ti.AsType()).ToArray()).PropertiesAutowired();
    // 第三步：配置 ContainerBuilder，返回 IServiceProvider 
    builder.Populate(services);
    return new AutofacServiceProvider(builder.Build());
}

#、构造函数注入&属性注入

描述来源于Abp.io中文文档：查看详情

构造方法注入

是将依赖项注入类的首选方式.这样,除非提供了所有构造方法注入的依赖项,否则无法构造类.因此,该类明确的声明了它必需的服务.

属性注入

public class MyService : ITransientDependency
{
public ILogger<MyService> Logger { get; set; }

      public MyService()
      {
          Logger = NullLogger<MyService>.Instance;
}

}

对于属性注入依赖项,使用公开的setter声明公共属性.这允许DI框架在创建类之后设置它.
属性注入依赖项通常被视为可选依赖项.这意味着没有它们,服务也可以正常工作.Logger就是这样的依赖项,MyService可以继续工作而无需日志记录.
为了使依赖项成为可选的,我们通常会为依赖项设置默认/后备(fallback)值.在此示例中,NullLogger用作后备.因此,如果DI框架或你在创建MyService后未设置Logger属性,则MyService依然可以工作但不写日志.
属性注入的一个限制是你不能在构造函数中使用依赖项,因为它是在对象构造之后设置的.
当你想要设计一个默认注入了一些公共服务的基类时,属性注入也很有用.如果你打算使用构造方法注入,那么所有派生类也应该将依赖的服务注入到它们自己的构造方法中,这使得开发更加困难.但是,对于非可选服务使用属性注入要非常小心,因为它使得类的要求难以清楚地看到.