Utf8JsonReader.ValueSequence Własność
Definicja
Ważny
Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.
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ść nieruchomości
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.