Utf8JsonReader.ValueSpan Właściwość

Definicja

Przestrzeń nazw:

System.Text.Json

Zestaw:

System.Text.Json.dll

Pakiet:

System.Text.Json v9.0.0-preview.3.24172.9

Źródło:

Utf8JsonReader.cs

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

ReadOnlySpan<Byte>

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.