Utf8JsonReader.ValueSpan Свойство

Определение

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

System.Text.Json

Сборка:

System.Text.Json.dll

Пакет:

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

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

Utf8JsonReader.cs

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

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

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

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