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.


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


定义一个自定义异常对象,当遇到无效 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.


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


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


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


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



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


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


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


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


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


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


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


定义一个不透明类型,用于保留和保存所有相关的状态信息,这些信息必须提供给 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.


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


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



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


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


指定 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.