Utf8JsonReader.ValueSequence Свойство

Определение

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

System.Text.Json

Сборка:

System.Text.Json.dll

Пакет:

System.Text.Json v11.0.0-preview.5.26302.115

Исходный код:

Utf8JsonReader.cs

Возвращает необработанное значение последнего обработанного маркера в виде байтового среза байтов> 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<и срезе, представляющего значение маркера, помещается в один сегмент, то ValueSpan содержит срезное значение, так как оно может быть представлено в виде диапазона. ValueSequence В противном случае содержит значение маркера.

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

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

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