Utf8JsonReader.ValueSequence 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 wycinka bajtów> readOnlySequence<ładunku wejściowego, tylko wtedy, gdy token znajduje się w wielu segmentach.

public:
 property System::Buffers::ReadOnlySequence<System::Byte> ValueSequence { System::Buffers::ReadOnlySequence<System::Byte> get(); };

public System.Buffers.ReadOnlySequence<byte> ValueSequence { get; }

member this.ValueSequence : System.Buffers.ReadOnlySequence<byte>

Public ReadOnly Property ValueSequence As ReadOnlySequence(Of Byte)

Wartość właściwości

ReadOnlySequence<Byte>

Sekwencja 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 false, ValueSequence jest pusta. W związku z tym dostęp ValueSequence tylko wtedy, gdy HasValueSequence ma wartość true. W przeciwnym razie należy uzyskać dostęp do wartości tokenu z ValueSpanwitryny .

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 metodę ValueTextEquals, która w razie potrzeby odsłania tekst.