System.Text.Json 命名空间

System.Text.Json 命名空间提供高性能、低分配以及符合标准的功能来处理 JavaScript 对象表示法 (JSON),其中包括将对象序列化为 JSON 文本以及将 JSON 文本反序列化为对象(内置 UTF-8 支持)。 The System.Text.Json namespace provides high-performance, low-allocating, and standards-compliant capabilities to process JavaScript Object Notation (JSON), which includes serializing objects to JSON text and deserializing JSON text to objects, with UTF-8 support built-in. 它还提供类型以用于读取和写入编码为 UTF-8 的 JSON 文本,以及用于创建内存中文档对象模型 (DOM) 以在数据的结构化视图中随机访问 JSON 元素。 It also provides types to read and write JSON text encoded as UTF-8, and to create an in-memory document object model (DOM) for random access of the JSON elements within a structured view of the data.

JsonDocument

提供用于检查 JSON 值的结构内容,而不自动实例化数据值的机制。Provides a mechanism for examining the structural content of a JSON value without automatically instantiating data values.

JsonException

定义一个自定义异常对象,当遇到无效 JSON 文本、传递已定义的最大深度或 JSON 文本与对象上的属性类型不兼容时,则引发该异常对象。Defines a custom exception object that is thrown when invalid JSON text is encountered, when the defined maximum depth is passed, or the JSON text is not compatible with the type of a property on an object.

JsonNamingPolicy

确定用于将基于字符串的名称转换为其他格式(如 camel 大小写格式)的命名策略。Determines the naming policy used to convert a string-based name to another format, such as a camel-casing format.

JsonSerializer

提供将对象或值类型序列化为 JSON 以及将 JSON 反序列化为对象或值类型的功能。Provides functionality to serialize objects or value types to JSON and to deserialize JSON into objects or value types.

JsonSerializerOptions

提供与 JsonSerializer 一起使用的选项。Provides options to be used with JsonSerializer.

Utf8JsonWriter

提供高性能的 API,以便提供 UTF-8 编码 JSON 文本的只进和非缓存编写权限。Provides a high-performance API for forward-only, non-cached writing of UTF-8 encoded JSON text.

结构

JsonDocumentOptions

分析 JSON 以创建 JsonDocument 时,为用户提供定义自定义行为的功能。Provides the ability for the user to define custom behavior when parsing JSON to create a JsonDocument.

JsonElement

表示 JsonDocument 中的特定 JSON 值。Represents a specific JSON value within a JsonDocument.

JsonElement.ArrayEnumerator

表示一个针对 JSON 数组内容的枚举器。Represents an enumerator for the contents of a JSON array.

JsonElement.ObjectEnumerator

表示一个针对 JSON 对象属性的枚举器。Represents an enumerator for the properties of a JSON object.

JsonEncodedText

提供将 UTF-8 或 UTF-16 编码文本转换为适用于 JSON 的表单的方法。Provides methods to transform UTF-8 or UTF-16 encoded text into a form that is suitable for JSON.

JsonProperty

表示 JSON 对象的单个属性。Represents a single property for a JSON object.

JsonReaderOptions

读取 JSON 时,为用户提供定义自定义行为的功能。Provides the ability for the user to define custom behavior when reading JSON.

JsonReaderState

定义一个不透明类型,用于保留和保存所有相关的状态信息,这些信息必须提供给 Utf8JsonReader,以便在处理不完整的数据后继续进行读取。Defines an opaque type that holds and saves all the relevant state information, which must be provided to the Utf8JsonReader to continue reading after processing incomplete data.

JsonWriterOptions

允许用户在使用 Utf8JsonWriter 编写 JSON 时定义自定义行为。Allows the user to define custom behavior when writing JSON using the Utf8JsonWriter.

Utf8JsonReader

提供高性能的 API,以便提供对 UTF-8 编码 JSON 文本的只进和只读访问权限。Provides a high-performance API for forward-only, read-only access to UTF-8 encoded JSON text.

枚举

JsonCommentHandling

定义 Utf8JsonReader 结构处理注释的方式。Defines how the Utf8JsonReader struct handles comments.

JsonTokenType

定义组成 JSON 文本的各种 JSON 令牌。Defines the various JSON tokens that make up a JSON text.

JsonValueKind

指定 JSON 值的数据类型。Specifies the data type of a JSON value.

注解

另请参阅 System.Text.Json.Serialization 命名空间,该命名空间包含用于高级方案的属性和 Api,以及特定于序列化和反序列化的自定义。See also the System.Text.Json.Serialization namespace, which contains attributes and APIs for advanced scenarios and customization specific to serialization and deserialization.

有关详细信息,请参阅system.web 概述For more information, see the System.Text.Json overview.