База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

Utf8JsonReader — четене на JSON токени от UTF-8

Utf8JsonReader от System.Text.Json чете JSON байтове, кодирани в UTF-8, токен по токен и само напред. Позволява да избирате нужните стойности, без да изграждате дърво на документа или да десериализирате документа в обекти.

Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Синтаксис

var reader = new Utf8JsonReader(utf8Json);
while (reader.Read())
{
    // Inspect reader.TokenType and read the current token's value.
}

Utf8JsonReader е променлив ref struct от System.Text.Json, наличен в .NET 10. Приема ReadOnlySpan<byte> или ReadOnlySequence<byte>. Не изгражда дърво на документа; извикващият код сам интерпретира последователните токени и структурата на JSON.

Read() преминава към следващия токен, а TokenType показва вида му. Методи като GetInt32() прочитат текущата стойност, без да придвижват четеца. Проверявайте вида на токена, преди да ги извикате; числото трябва също да се побира в целевия тип. ValueTextEquals() сравнява име или текст, като отчита escape последователностите в JSON, без да създава междинен string.

Четецът не може да се съхранява в поле на клас или да се запазва през граница await. Подайте го с ref на помощна функция, която трябва да придвижи оригиналния четец; копието има независима позиция. При вход с няколко сегмента проверете HasValueSequence, преди да изберете ValueSequence или ValueSpan.

Конструкторът в примера предполага цял документ. При вход на порции използвайте isFinalBlock, запазете CurrentState и непрочетените байтове, посочени от BytesConsumed, а след подаване на още данни създайте нов четец. Самото състояние не съхранява тези байтове. Когато Read() открие синтактична грешка в JSON, хвърля изключение JsonException. Методът обаче може да разпознае низ в кавички като токен дори ако низът съдържа невалидни UTF-8 последователности. При декодиране на такъв токен GetString() може да хвърли InvalidOperationException вместо JsonException. Коментарите и крайните запетаи по подразбиране не са разрешени.

Примери

using System;
using System.Text.Json;

ReadOnlySpan<byte> json = "{\"name\":\"Ada\",\"age\":25}"u8;
var reader = new Utf8JsonReader(json);

while (reader.Read())
{
    if (reader.TokenType == JsonTokenType.PropertyName &&
        reader.ValueTextEquals("age"u8))
    {
        if (!reader.Read() || reader.TokenType != JsonTokenType.Number)
            throw new JsonException("Expected a number.");

        Console.WriteLine(reader.GetInt32());
    }
}

Резултат

25

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници