c# JsonDocument是什么结构？

在 C# 中，`JsonDocument` 是 Newtonsoft.Json 库提供的一个类，它代表了一个完整的 JSON 文档。它是 Newtonsoft.Json 的低级别的 JSON 解析器，允许开发者以树状结构的形式访问和操作 JSON 数据，而不是逐行或字符地解析。`JsonDocument` 结构类似于一个内存中的 DOM 树，其中包含了整个 JSON 内容的对象和数组节点。

当你通过 `JsonDocument.Parse()` 或 `JsonDocument.Load()` 方法从 JSON 字符串或文件中创建一个 `JsonDocument` 对象时，它的根节点就是整个 JSON 数据的顶级元素，如对象（Object）、数组（Array）、字符串、数字、布尔值等。你可以通过 `.RootElement` 属性获取这个根节点，然后通过 `.Descendants()` 或 `.Nodes()` 方法遍历其子节点，以及使用导航属性（如 `.GetProperty()`、`.GetArrayElement()` 等）访问具体的属性和元素。

`JsonDocument` 提供了一种更高效的方式来处理大型或复杂的 JSON 数据，因为它是在内存中一次性加载整个文档，而不是像 `JsonTextReader` 那样按需解析。这样对于性能敏感的应用场景非常有用。

举个简单的例子：

using JsonDocument;
// ...

string jsonString = "{\"name\":\"John\", \"age\":30, \"city\":\"New York\"}";
JsonDocument document = await JsonDocument.ParseAsync(jsonString);

JsonElement rootElement = document.RootElement;
string name = rootElement.GetProperty("name").GetString();
int age = rootElement.GetProperty("age").GetInt32();
string city = rootElement.GetProperty("city").GetString();

在这个例子中，我们首先创建了一个 `JsonDocument`，然后通过属性直接获取到了 JSON 中的值。