为什么需要新的 JSON API ？
JSON.NET 大家都用过，老版本的 ASP.NET Core 也依赖于 JSON.NET 。
然而这个依赖就会引起一些版本问题：例如 ASP .NET Core某个版本需要使用 JSON .NET v10 ，而另一个库需要使用 JSON.NET v11 ；或者 JSON .NET 出现了一个新版本，而ASP .NET Core 还不能支持这个版本，而您却想使用该版本。
System.Text.Json
随着 NET Core 3.0 的出现，出现了 System .Text.Json 命名空间和它下面一些用于处理 JSON 的类。
特点
这个内置 JSON API 具有与生俱来的高性能、地分配的特点：
JSON .NET 使用 .NET 里面的字符串作为基本数据类型，其实也就是 UTF16 ，而 .NET Core 中新的 JSON API 直接使用数据原始的 UTF8 格式。
新的 JSON API 基于 Span <byte> 这个数据类型来进行操作 JSON 数据，从而具有低分配的特点，这就可以极大的改善吞吐量和内存使用情况。
但是新的JSON API 的特性还不那么丰富，有一些 JSON .NET 具有的特性都还不支持。
例子
随便找了一个 JSON 示例文件：
针对这个文件，需要修改一下它的属性：
Utf8JsonReader
先使用 Utf8JsonReader 来读取JSON文件。
Utf8JsonReader 并不会读取文件或者 stream ，它会读取Span数据类型。
直接上代码：
Main方法里面，我们使用 File .ReadAllBytes 从 sample .json 文件读取数格式为 byte[] ，然后通过 AsSpan 这个扩展方法将其转化为 Span <byte> 数据类型，然后把它传递到 Utf8JsonReader 的构造函数来创建一个JSON的 reader 。
接下来使用while循环对JSON数据的每个 Token 进行读取，每次执行 Read() 方法时， reader 就会移动到 JSON 数据里面的下一个 Token 那里。
Token 分成几种类型， GetToken Info 方法就是判断一下 Token 的类型，并返回一些描述性信息，这里面应该是包含了所有的类型。这里面使用到了C# 8 的 switch 表达式。
运行程序
结果如下：
可以看到 sample.json 文件里面的每个 Token 都被正确的显示了。
Json Document 类
Json Document 是基于 Utf8JsonReader 构建的 。 JsonDocument 可分析 JSON 数据并生成只读文档对象模型 (DOM) ，可对模型进行查询，以支持随机访问和枚举。使用 JsonDocument 分析常规 JSON 有效负载并访问其所有成员比使用 Json.NET 快 2-3 倍，且为合理大小（即 < 1 MB ）的数据所分配的量非常少。
