Utf8JsonReader.ValueSequence Свойство

Определение

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

System.Text.Json

Сборка:

System.Text.Json.dll

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

public:
 property System::Buffers::ReadOnlySequence<System::Byte> ValueSequence { System::Buffers::ReadOnlySequence<System::Byte> get(); };

public System.Buffers.ReadOnlySequence<byte> ValueSequence { get; }

member this.ValueSequence : System.Buffers.ReadOnlySequence<byte>

Public ReadOnly Property ValueSequence As ReadOnlySequence(Of Byte)

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

ReadOnlySequence<Byte>

Последовательность только для чтения байтов.

Комментарии

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

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

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

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