Utf8JsonReader.ValueSpan Eigenschaft

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Source:

Utf8JsonReader.cs

Ruft den Rohwert des zuletzt verarbeiteten Tokens als ReadOnlySpan<byte>-Slice der Eingangsnutzlast ab, wenn das Token in ein einzelnes Segment passt oder wenn der Leser mit einer JSON-Nutzlast konstruiert 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

ReadOnlySpan<Byte>

Ein schreibgeschützter Bytes-Span.

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.

Wenn HasValueSequence ist true, ValueSpan ist leer. Greifen Sie daher nur zu ValueSpan , wenn HasValueSequence ist false. Andernfalls muss über ValueSequenceauf den Tokenwert zugegriffen werden.

Es gibt keine Garantie, dass diese Eigenschaft immer wohlgeformte Daten enthält. Wenn der an das Utf8JsonReader übergebene Eingabe-JSON ungültige UTF-8-Bytes innerhalb von JSON-Zeichenfolgentoken enthält, gibt diese Eigenschaft die ungültigen UTF-8-Bytes wie vorhanden zurück. Rufen Sie GetString() daher auf, wenn die Eingabe nicht vertrauenswürdig oder zuvor nicht überprüft wurde, 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 , um den Text bei Bedarf aufzuheben.