CKTIS / C#
Utf8JsonWriter — sekvencijalno zapisivanje JSON-a u UTF-8
Utf8JsonWriter iz System.Text.Json omogućuje ručno zapisivanje JSON-a kao UTF-8 bajtova u Stream ili IBufferWriter<byte>. Vi određujete redoslijed svojstava i strukturu dokumenta, a writer se brine za sintaksu JSON-a i escapiranje nizova.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
using var writer = new Utf8JsonWriter(destination, new JsonWriterOptions { Indented = false });
writer.WriteStartObject();
writer.WriteString("name", "Ada");
writer.WriteEndObject();
writer.Flush();Utf8JsonWriter u prostoru naziva System.Text.Json niskorazinski je mehanizam za sekvencijalno zapisivanje JSON-a kao UTF-8 bajtova u Stream ili IBufferWriter<byte>. Umjesto automatske serijalizacije cijelog objekta, izričito zapisujete njegova svojstva i vrijednosti. Koristan je za izradu prilagođenih serijalizatora, ali nije stablo dokumenta koje se može uređivati.
Pozivi WriteStartObject() i WriteEndObject() omeđuju objekt. WriteString("name", "Ada") zapisuje par naziv-vrijednost, dok WriteStringValue("csharp") zapisuje samo vrijednost, primjerice element polja. WriteStartArray("tags") započinje svojstvo polja, koje zatvara WriteEndArray(). Metode za zapisivanje nizova obrađuju potrebno escapiranje — nemojte stvarati JSON spajanjem teksta.
Prema zadanim postavkama izlaz je kompaktan, a provjera strukture uključena; neispravan niz operacija može uzrokovati InvalidOperationException. JsonWriterOptions omogućuje konfiguriranje, među ostalim, opcija Indented i SkipValidation. Isključivanjem provjere odgovornost za ispravnu strukturu prelazi na pozivajući kod.
Prije čitanja rezultata pozovite Flush() kako bi se bajtovi na čekanju prenijeli na odredište. To ne zamjenjuje zatvaranje objekata i polja odgovarajućim metodama. Upotrijebite using za oslobađanje writera. U primjeru Encoding.UTF8.GetString(...) pretvara zapisane bajtove u tekst isključivo radi prikaza. Korišteni API-ji dostupni su u .NET 10 i ne zahtijevaju jezične značajke u preview verziji.
Primjeri
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()));Rezultat
{"name":"Ada","score":42,"tags":["csharp","json"]}Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.