CKTIS / C#
Utf8JsonWriter — sequentieel JSON schrijven in UTF-8
Met Utf8JsonWriter uit System.Text.Json kun je JSON handmatig als UTF-8-bytes naar een Stream of IBufferWriter<byte> schrijven. Je bepaalt de volgorde van eigenschappen en de documentstructuur; de writer verzorgt de JSON-syntaxis en het escapen van tekenreeksen.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
using var writer = new Utf8JsonWriter(destination, new JsonWriterOptions { Indented = false });
writer.WriteStartObject();
writer.WriteString("name", "Ada");
writer.WriteEndObject();
writer.Flush();Utf8JsonWriter in de naamruimte System.Text.Json is een mechanisme op laag niveau om JSON sequentieel als UTF-8-bytes naar een Stream of IBufferWriter<byte> te schrijven. In plaats van een volledig object automatisch te serialiseren, schrijf je de eigenschappen en waarden ervan expliciet. Dit is handig voor het bouwen van aangepaste serializers, maar het is geen bewerkbare documentboom.
De aanroepen WriteStartObject() en WriteEndObject() begrenzen een object. WriteString("name", "Ada") schrijft een naam-waardepaar, terwijl WriteStringValue("csharp") alleen een waarde schrijft, bijvoorbeeld een array-element. WriteStartArray("tags") begint een array-eigenschap, die met WriteEndArray() wordt afgesloten. Methoden voor het schrijven van tekenreeksen verzorgen de vereiste escapeverwerking: bouw JSON niet op door tekst samen te voegen.
Standaard is de uitvoer compact en is structurele validatie ingeschakeld; een ongeldige reeks bewerkingen kan een InvalidOperationException veroorzaken. Met JsonWriterOptions kun je onder andere Indented en SkipValidation instellen. Als je validatie uitschakelt, wordt de aanroepende code verantwoordelijk voor een correcte structuur.
Roep vóór het lezen van het resultaat Flush() aan om wachtende bytes naar de bestemming te schrijven. Dit vervangt niet het afsluiten van objecten en arrays met de daarvoor bestemde methoden. Gebruik using om de writer vrij te geven. In het voorbeeld zet Encoding.UTF8.GetString(...) de geschreven bytes uitsluitend voor weergave om naar tekst. De gebruikte API’s zijn beschikbaar in .NET 10 en vereisen geen previewtaalfuncties.
Voorbeelden
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()));Resultaat
{"name":"Ada","score":42,"tags":["csharp","json"]}De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.