Utf8JsonReader.ValueSpan Свойство

Определение

Пространство имен:

System.Text.Json

Сборка:

System.Text.Json.dll

Получает необработанное значение последнего обработанного токена в виде среза полезных входных данных ReadOnlySpan<байт>, если токен помещается в один сегмент или если модуль чтения был создан с использованием полезных данных JSON, содержащихся в ReadOnlySpan<байт>.

public:
 property ReadOnlySpan<System::Byte> ValueSpan { ReadOnlySpan<System::Byte> get(); };

public ReadOnlySpan<byte> ValueSpan { get; }

member this.ValueSpan : ReadOnlySpan<byte>

Public ReadOnly Property ValueSpan As ReadOnlySpan(Of Byte)

Значение свойства

ReadOnlySpan<Byte>

Массив байтов с доступом только для чтения.

Комментарии

Если JSON предоставляется внутри ReadOnlySequence<byte> и срез, представляющий значение токена, умещается в отдельный сегмент, то ValueSpan содержит фрагментированное значение, так как его можно представить в виде диапазона. В противном случае ValueSequence содержит значение токена.

Если HasValueSequence значение равно true, ValueSpan пусто. Таким образом, доступ ValueSpan осуществляется только в том случае HasValueSequence false. В противном случае необходимо получить доступ к значению токена из ValueSequence.

Нет никакой гарантии, что это свойство всегда будет содержать правильно сформированные данные. Если входной код JSON, переданный в Utf8JsonReader содержащий недопустимые байты UTF-8 в строковых токенах JSON, это свойство вернет недопустимые байты UTF-8 как есть. Таким образом, если входные данные не являются доверенными или не проверены ранее, вызовите GetString() для получения токена строки JSON.

Так как это свойство возвращает необработанные байты, не используйте его для сравнения текста. Вместо этого вызовите ValueTextEquals , что при необходимости отменяет текст.