System.Text.Json 命名空间
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供高性能、低分配和符合标准的功能来处理 JavaScript 对象表示法（JSON），其中包括将对象序列化为 JSON 文本并将 JSON 文本反序列化为对象，而 UTF-8 支持内置。 它还提供类型来读取和写入编码为 UTF-8 的 JSON 文本，并创建内存中文档对象模型 （DOM），以便在数据的结构化视图中随机访问 JSON 元素。
类
| 名称 | 说明 |
|---|---|
| JsonDocument |
提供一种机制，用于检查 JSON 值的结构内容，而无需自动实例化数据值。 |
| JsonException |
定义在遇到无效 JSON 文本、传递定义的最大深度或 JSON 文本与对象属性的类型不兼容时引发的自定义异常对象。 |
| JsonNamingPolicy |
确定用于将基于字符串的名称转换为另一种格式（如 camel 大小写格式）的命名策略。 |
| JsonSerializer |
提供将对象或值类型序列化为 JSON 以及将 JSON 反序列化为对象或值类型的功能。 |
| JsonSerializerOptions |
提供要与 . 一起使用 JsonSerializer的选项。 |
| Utf8JsonWriter |
为 UTF-8 编码 JSON 文本的仅进非缓存写入提供高性能 API。 |
结构
| 名称 | 说明 |
|---|---|
| JsonDocumentOptions |
为用户提供在分析 JSON 以创建 JsonDocument自定义行为时定义自定义行为的功能。 |
| JsonElement |
表示一个 JsonDocument中特定的 JSON 值。 |
| JsonElement.ArrayEnumerator |
表示 JSON 数组内容的枚举器。 |
| JsonElement.ObjectEnumerator |
表示 JSON 对象的属性的枚举器。 |
| JsonEncodedText |
提供将 UTF-8 或 UTF-16 编码文本转换为适合 JSON 的表单的方法。 |
| JsonProperty |
表示 JSON 对象的单个属性。 |
| JsonReaderOptions |
为用户提供读取 JSON 时定义自定义行为的功能。 |
| JsonReaderState |
定义一个不透明类型，该类型保存并保存所有相关状态信息，必须在处理不完整的数据后继续 Utf8JsonReader 读取这些信息。 |
| JsonWriterOptions |
允许用户使用 Utf8JsonWriter 编写 JSON 时定义自定义行为。 |
| Utf8JsonReader |
提供高性能 API，用于对 UTF-8 编码的 JSON 文本进行向前只读访问。 |
枚举
| 名称 | 说明 |
|---|---|
| JsonCommentHandling |
定义 Utf8JsonReader 结构如何处理注释。 |
| JsonSerializerDefaults |
指定可用于构造 JsonSerializerOptions 实例的基于方案的默认序列化选项。 |
| JsonTokenType |
定义构成 JSON 文本的各种 JSON 令牌。 |
| JsonValueKind |
指定 JSON 值的数据类型。 |
注解
另 System.Text.Json.Serialization 请参阅命名空间，其中包含高级方案和特定于序列化和反序列化的自定义的属性和 API。
有关详细信息，请参阅 System.Text.Json 概述。
