Udostępnij za pośrednictwem


Utf8JsonReader.ValueSpan Właściwość

Definicja

Pobiera nieprzetworzoną wartość ostatniego przetworzonego tokenu jako fragment bajtu readOnlySpan<> ładunku wejściowego, jeśli token mieści się w jednym segmencie lub jeśli czytnik został skonstruowany z ładunkiem JSON zawartym w bajtach> 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)

Wartość właściwości

Zakres tylko do odczytu bajtów.

Uwagi

Jeśli kod JSON jest dostarczany w bajtach> ReadOnlySequence<i wycinek reprezentujący wartość tokenu pasuje do pojedynczego segmentu, zawiera wartość wycinkową, ValueSpan ponieważ może być reprezentowana jako zakres. ValueSequence W przeciwnym razie zawiera wartość tokenu.

Jeśli HasValueSequence wartość to true, ValueSpan jest pusta. W związku z tym dostęp ValueSpan tylko wtedy, gdy HasValueSequence ma wartość false. W przeciwnym razie należy uzyskać dostęp do wartości tokenu z ValueSequencewitryny .

Nie ma gwarancji, że ta właściwość zawsze będzie zawierać dobrze sformułowane dane. Jeśli wejściowy kod JSON przekazany do obiektu Utf8JsonReader zawiera nieprawidłowe bajty UTF-8 w tokenach ciągu JSON, ta właściwość zwróci te nieprawidłowe bajty UTF-8, tak jak to jest. W związku z tym, jeśli dane wejściowe są niezaufane lub nie zostały wcześniej zweryfikowane, wywołaj polecenie GetString() , aby uzyskać token ciągu JSON.

Ponieważ ta właściwość zwraca nieprzetworzone bajty, unikaj używania jej do porównania tekstu. Zamiast tego wywołaj ValueTextEquals element, który w razie potrzeby odsłania tekst.

Dotyczy