System.Text.Json Namespace

Пространство имен System.Text.JSON обеспечивает высокопроизводительные, не требовательные к памяти и соответствующие стандартам возможности обработки 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. Оно также предоставляет типы для чтения и записи текста JSON в кодировке UTF-8 и для создания модели 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.

Classes

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 для однонаправленной некэшированной записи текста JSON в кодировке UTF-8.Provides a high-performance API for forward-only, non-cached writing of UTF-8 encoded JSON text.

Structs

JsonDocumentOptions

Предоставляет пользователю возможность определить пользовательское поведение при анализе JSON для создания JsonDocument.Provides the ability for the user to define custom behavior when parsing JSON to create a JsonDocument.

JsonElement

Представляет определенное значение JSON в JsonDocument.Represents a specific JSON value within a JsonDocument.

JsonElement.ArrayEnumerator

Represents an enumerator for the contents of a JSON array.Represents an enumerator for the contents of a JSON array.

JsonElement.ObjectEnumerator

Представляет перечислитель для свойств объекта JSON.Represents an enumerator for the properties of a JSON object.

JsonEncodedText

Provides methods to transform UTF-8 or UTF-16 encoded text into a form that is suitable for JSON.Provides methods to transform UTF-8 or UTF-16 encoded text into a form that is suitable for JSON.

JsonProperty

Represents a single property for a JSON object.Represents a single property for a JSON object.

JsonReaderOptions

Предоставляет пользователю возможность определить пользовательское поведение при чтении JSON.Provides the ability for the user to define custom behavior when reading JSON.

JsonReaderState

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

Разрешает пользователю определить пользовательское поведение при чтении JSON с помощью Utf8JsonWriter.Allows the user to define custom behavior when writing JSON using the Utf8JsonWriter.

Utf8JsonReader

Предоставляет высокопроизводительный API для однонаправленного доступа только для чтения к тексту JSON в кодировке UTF-8.Provides a high-performance API for forward-only, read-only access to UTF-8 encoded JSON text.

Enums

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.

Remarks

См. также пространство имен 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. Text. JSON.For more information, see the System.Text.Json overview.