CKTIS / C#
Utf8JsonWriter — последователно записване на JSON в UTF-8
Utf8JsonWriter от System.Text.Json позволява ръчно да записвате JSON като UTF-8 байтове в Stream или IBufferWriter<byte>. Вие управлявате реда на свойствата и структурата на документа, а writer се грижи за синтаксиса на JSON и екранирането на низовете.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
using var writer = new Utf8JsonWriter(destination, new JsonWriterOptions { Indented = false });
writer.WriteStartObject();
writer.WriteString("name", "Ada");
writer.WriteEndObject();
writer.Flush();Utf8JsonWriter в пространството от имена System.Text.Json е механизъм на ниско ниво за последователно записване на JSON като UTF-8 байтове в Stream или IBufferWriter<byte>. Вместо автоматично да сериализирате цял обект, изрично записвате свойствата и стойностите му. Полезен е за създаване на персонализирани сериализатори, но не представлява дърво на документ, което може да се редактира.
Извикванията WriteStartObject() и WriteEndObject() очертават обект. WriteString("name", "Ada") записва двойка име-стойност, докато WriteStringValue("csharp") записва само стойност, например елемент от масив. WriteStartArray("tags") започва свойство-масив, което се затваря с WriteEndArray(). Методите за записване на низове обработват необходимото екраниране — не създавайте JSON чрез съединяване на текст.
По подразбиране изходът е компактен, а структурната проверка е включена; невалидна последователност от операции може да причини InvalidOperationException. JsonWriterOptions позволява да зададете, наред с други настройки, Indented и SkipValidation. Ако изключите проверката, отговорността за правилната структура преминава към извикващия код.
Преди да прочетете резултата, извикайте Flush(), за да предадете чакащите байтове към целта. Това не замества затварянето на обектите и масивите със съответните методи. Използвайте using, за да освободите writer. В примера Encoding.UTF8.GetString(...) преобразува записаните байтове в текст единствено за показване. Използваните API са налични в .NET 10 и не изискват езикови функции в preview версия.
Примери
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()));Резултат
{"name":"Ada","score":42,"tags":["csharp","json"]}Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.