CKTIS / C#
Utf8JsonWriter — écriture séquentielle de JSON en UTF-8
Utf8JsonWriter de System.Text.Json permet d’écrire manuellement du JSON sous forme d’octets UTF-8 dans un Stream ou un IBufferWriter<byte>. Vous contrôlez l’ordre des propriétés et la structure du document, tandis que le writer gère la syntaxe JSON et l’échappement des chaînes.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
using var writer = new Utf8JsonWriter(destination, new JsonWriterOptions { Indented = false });
writer.WriteStartObject();
writer.WriteString("name", "Ada");
writer.WriteEndObject();
writer.Flush();Utf8JsonWriter, dans l’espace de noms System.Text.Json, est un mécanisme de bas niveau qui écrit séquentiellement du JSON sous forme d’octets UTF-8 dans un Stream ou un IBufferWriter<byte>. Au lieu de sérialiser automatiquement un objet entier, vous écrivez explicitement ses propriétés et ses valeurs. Il est utile pour créer des sérialiseurs personnalisés, mais ne constitue pas un arbre de document modifiable.
Les appels WriteStartObject() et WriteEndObject() délimitent un objet. WriteString("name", "Ada") écrit une paire nom-valeur, tandis que WriteStringValue("csharp") écrit uniquement une valeur, par exemple un élément de tableau. WriteStartArray("tags") commence une propriété tableau, que WriteEndArray() ferme. Les méthodes d’écriture de chaînes prennent en charge l’échappement nécessaire : ne construisez pas le JSON en concaténant du texte.
Par défaut, la sortie est compacte et la validation de la structure est activée ; une séquence d’opérations incorrecte peut provoquer une InvalidOperationException. JsonWriterOptions permet de configurer notamment Indented et SkipValidation. Désactiver la validation transfère au code appelant la responsabilité de garantir une structure correcte.
Avant de lire le résultat, appelez Flush() pour transférer les octets en attente vers la destination. Cela ne remplace pas la fermeture des objets et des tableaux avec les méthodes appropriées. Utilisez using pour libérer le writer. Dans l’exemple, Encoding.UTF8.GetString(...) convertit les octets écrits en texte uniquement pour l’affichage. Les API utilisées sont disponibles dans .NET 10 et ne nécessitent aucune fonctionnalité de langage en préversion.
Exemples
using System;
using System.IO;
using System.Text;
using System.Text.Json;
using var stream = new MemoryStream();
using var writer = new Utf8JsonWriter(stream);
writer.WriteStartObject();
writer.WriteString("name", "Ada");
writer.WriteNumber("score", 42);
writer.WriteStartArray("tags");
writer.WriteStringValue("csharp");
writer.WriteStringValue("json");
writer.WriteEndArray();
writer.WriteEndObject();
writer.Flush();
Console.WriteLine(Encoding.UTF8.GetString(stream.ToArray()));Résultat
{"name":"Ada","score":42,"tags":["csharp","json"]}Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.