Utf8JsonReader.ValueSequence Eigenschaft

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Ruft den Rohwert des zuletzt verarbeiteten Tokens als ReadOnlySequence<byte>-Slice der Eingangsnutzlast nur ab, wenn das Token in mehreren Segmenten enthalten ist.

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)

Eigenschaftswert

ReadOnlySequence<Byte>

Eine schreibgeschützte Bytesequenz.

Hinweise

Wenn der JSON-Code innerhalb eines ReadOnlySequence<Byte> bereitgestellt wird und der Slice, der den Tokenwert darstellt, in ein einzelnes Segment passt, enthält ValueSpan den Slicewert, da es als ein Bereich dargestellt werden kann. Andernfalls enthält ValueSequence den Tokenwert.

falseIst dies der ValueSequence GrundHasValueSequence, ist leer. Daher gilt nur der Zugriff ValueSequence , wenn HasValueSequence es sich um true. Andernfalls muss auf den Tokenwert zugegriffen ValueSpanwerden.

Es gibt keine Garantie, dass diese Eigenschaft immer gut gebildete Daten enthält. Wenn die an die Utf8JsonReader JSON übergebene Eingabe-JSON ungültige UTF-8 Bytes innerhalb von JSON-Zeichenfolgentoken enthält, gibt diese Eigenschaft diese ungültigen UTF-8 Bytes wie folgt zurück. Wenn die Eingabe daher nicht vertrauenswürdig ist oder noch 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 stattdessen auf ValueTextEquals, was den Text bei Bedarf unbildet.