System.Text.Json Namespace

L’espace de noms System.Text.Json offre des fonctionnalités hautes performances, à faible allocation et conformes aux normes pour traiter JSON (JavaScript Object Notation), qui inclut la sérialisation des objets en texte JSON et la désérialisation du texte JSON en objets, avec une prise en charge intégrée d’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. Il fournit aussi des types pour lire et écrire du texte JSON encodé en UTF-8, et pour créer un modèle DOM (Document Object Model) en mémoire dédié à l’accès aléatoire des éléments JSON au sein d’une vue structurée des données. 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

Fournit un mécanisme permettant d’examiner le contenu structurel d’une valeur JSON sans instancier automatiquement des valeurs de données.Provides a mechanism for examining the structural content of a JSON value without automatically instantiating data values.

JsonException

Définit un objet exception personnalisé qui est levé lorsque du texte JSON non valide a été trouvé, que la profondeur maximale définie est passée ou que le texte JSON n’est pas compatible avec le type d’une propriété sur un objet.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

Détermine la stratégie de nommage utilisée pour convertir un nom basé sur une chaîne en un autre format, tel qu’un format de casse mixte.Determines the naming policy used to convert a string-based name to another format, such as a camel-casing format.

JsonSerializer

Fournit les fonctionnalités permettant de sérialiser des objets ou des types valeur en JSON et de désérialiser JSON en objets ou types valeur.Provides functionality to serialize objects or value types to JSON and to deserialize JSON into objects or value types.

JsonSerializerOptions

Fournit des options à utiliser avec JsonSerializer.Provides options to be used with JsonSerializer.

Utf8JsonWriter

Fournit une API hautes performances pour l’écriture en transfert seul et non mise en cache de texte JSON encodé en UTF-8.Provides a high-performance API for forward-only, non-cached writing of UTF-8 encoded JSON text.

Structures

JsonDocumentOptions

Offre la possibilité à l’utilisateur de définir un comportement personnalisé lors de l’analyse de JSON pour créer un JsonDocument.Provides the ability for the user to define custom behavior when parsing JSON to create a JsonDocument.

JsonElement

Représente une valeur JSON spécifique dans un JsonDocument.Represents a specific JSON value within a JsonDocument.

JsonElement.ArrayEnumerator

Représente un énumérateur pour le contenu d’un tableau JSON.Represents an enumerator for the contents of a JSON array.

JsonElement.ObjectEnumerator

Représente un énumérateur pour les propriétés d’un objet JSON.Represents an enumerator for the properties of a JSON object.

JsonEncodedText

Fournit des méthodes pour transformer du texte encodé en UTF-8 ou UTF-16 dans un format approprié pour JSON.Provides methods to transform UTF-8 or UTF-16 encoded text into a form that is suitable for JSON.

JsonProperty

Représente une propriété unique pour un objet JSON.Represents a single property for a JSON object.

JsonReaderOptions

Offre la possibilité à l’utilisateur de définir un comportement personnalisé lors de la lecture de JSON.Provides the ability for the user to define custom behavior when reading JSON.

JsonReaderState

Définit un type opaque qui détient et enregistre toutes les informations d’état pertinentes qui doivent être fournies au Utf8JsonReader pour continuer la lecture après avoir traité les données incomplètes.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

Autorise l’utilisateur à définir un comportement personnalisé lors de l’écriture de code JSON en utilisant le Utf8JsonWriter.Allows the user to define custom behavior when writing JSON using the Utf8JsonWriter.

Utf8JsonReader

Fournit une API hautes performances pour un accès en transfert seul et en lecture seule à du texte JSON encodé en UTF-8.Provides a high-performance API for forward-only, read-only access to UTF-8 encoded JSON text.

Énumérations

JsonCommentHandling

Définit comment le struct Utf8JsonReader gère les commentaires.Defines how the Utf8JsonReader struct handles comments.

JsonTokenType

Définit les différents jetons JSON qui composent un texte JSON.Defines the various JSON tokens that make up a JSON text.

JsonValueKind

Spécifie le type de données d’une valeur JSON.Specifies the data type of a JSON value.