Utf8JsonReader.ValueSpan Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.
