Utf8JsonReader.ValueSpan Vlastnost

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

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 k dispozici v bajte> ReadOnlySequence<a řez, který představuje hodnotu tokenu, odpovídá jednomu segmentu, pak ValueSpan obsahuje řeznou hodnotu, protože ji lze reprezentovat jako rozsah. ValueSequence V opačném případě obsahuje hodnotu tokenu.

Pokud HasValueSequence je , ValueSpan trueje prázdná. Proto pouze přístup, ValueSpan pokud 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 dobře vytvořená data. Pokud vstupní KÓD JSON předaný do souboru Utf8JsonReader obsahuje neplatné bajty UTF-8 v rámci tokenů řetězců JSON, vrátí tato vlastnost tyto neplatné bajty UTF-8, jak je. Proto pokud je vstup nedůvěryhodný nebo není dříve ověřený, voláním GetString() získejte token řetězce JSON.

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