Utf8JsonReader.ValueSpan Vlastnost

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

Balíček:

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

Zdroj:

Utf8JsonReader.cs

Získá nezpracovanou hodnotu posledního zpracovaného tokenu jako řez bajtu ReadOnlySpan<vstupní datové části, pokud se token vejde do jednoho segmentu nebo pokud byl čtenář vytvořen datovou částí JSON obsaženou v bajte> 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)

Hodnota vlastnosti

ReadOnlySpan<Byte>

Rozsah bajtů jen pro čtení.

Poznámky

Pokud je JSON zadaný v bajtu> ReadOnlySequence<a řez, který představuje hodnotu tokenu, se vejde do jednoho segmentu, pak obsahuje průřezovou hodnotu, ValueSpan protože ji lze reprezentovat jako rozsah. ValueSequence V opačném případě obsahuje hodnotu tokenu.

Pokud HasValueSequence je true, ValueSpan je prázdná. Proto přístup ValueSpan pouze v případě , že HasValueSequence je false. V opačném případě musí být hodnota tokenu přístupná z ValueSequence.

Není zaručeno, že tato vlastnost bude vždy obsahovat data ve správném formátu. Pokud vstupní KÓD JSON předaný do objektu Utf8JsonReader obsahuje neplatné bajty UTF-8 v rámci tokenů řetězců JSON, vrátí tato vlastnost tyto neplatné bajty UTF-8 tak, jak je. Proto pokud je vstup nedůvěryhodný nebo není dříve ověřen, volání GetString() pro získání tokenu řetězce JSON.

Vzhledem k tomu, že tato vlastnost vrací nezpracované bajty, nepoužívejte ji pro porovnání textu. Místo toho volejte ValueTextEquals , aby text v případě potřeby unescapes.