Utf8JsonReader.ValueSpan Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Rohwert des letzten verarbeiteten Tokens als ReadOnlySpan-Byte-Segment<> der Eingabenutzlast ab, wenn das Token in ein einzelnes Segment passt oder wenn der Leser mit einer JSON-Nutzlast erstellt wurde, die in einem ReadOnlySpan-Byte<> enthalten ist.
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)Eigenschaftswert
Eine schreibgeschützte Spanne von Bytes.
Hinweise
Wenn der JSON-Code in einem ReadOnlySequence-Byte<> bereitgestellt wird und das Segment, das den Tokenwert darstellt, in ein einzelnes Segment passt, enthält sie ValueSpan den segmentierten Wert, da er als Span dargestellt werden kann.
ValueSequence Enthält andernfalls den Tokenwert.
Ist HasValueSequence dies der Grund, ValueSpan ist trueleer.
Daher gilt nur der Zugriff ValueSpan , wenn HasValueSequence dies der Grund ist false.
Andernfalls muss auf den Tokenwert zugegriffen ValueSequencewerden.
Es gibt keine Garantie dafür, dass diese Eigenschaft immer wohlgeformte Daten enthält. Wenn die an die Utf8JsonReader JSON übergebene Eingabe ungültige UTF-8 Bytes innerhalb von JSON-Zeichenfolgentoken enthält, gibt diese Eigenschaft die ungültigen UTF-8 Bytes wie folgt zurück.
Wenn die Eingabe daher nicht vertrauenswürdig ist oder zuvor nicht überprüft wurde, rufen Sie GetString() auf, um das JSON-Zeichenfolgentoken abzurufen.
Da diese Eigenschaft die unformatierten Bytes zurückgibt, vermeiden Sie die Verwendung für den Textvergleich. Rufen Sie ValueTextEquals stattdessen den Text bei Bedarf auf, um den Text zu entwenden.
