Utf8JsonReader.ValueSpan Proprietà

Definizione

Spazio dei nomi:

System.Text.Json

Assembly:

System.Text.Json.dll

Pacchetto:

System.Text.Json v9.0.0-preview.3.24172.9

Origine:

Utf8JsonReader.cs

Ottiene il valore non elaborato dell'ultimo token elaborato come sezione di ReadOnlySpan<byte> del payload di input, se il token è contenuto in un solo segmento o se il lettore è stato costruito con un payload JSON contenuto in un oggetto ReadOnlySpan<byte>.

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)

Valore della proprietà

ReadOnlySpan<Byte>

Intervallo di sola lettura di byte.

Commenti

Se il token JSON viene fornito all'interno di una ReadOnlySequence<byte> e la sezione che rappresenta il valore del token rientra in un singolo segmento, ValueSpan contiene il valore suddiviso perché può essere rappresentato come un intervallo. In caso contrario, ValueSequence contiene il valore del token.

Se HasValueSequence è , ValueSpan è truevuoto. Pertanto, solo l'accesso ValueSpan se HasValueSequence è false. In caso contrario, il valore del token deve essere accessibile da ValueSequence.

Questa proprietà non contiene sempre dati ben formati. Se il codice JSON di input passato all'oggetto Utf8JsonReader contiene byte UTF-8 non validi all'interno di token di stringa JSON, questa proprietà restituirà tali byte UTF-8 non validi come è. Pertanto, se l'input non è attendibile o non è convalidato in precedenza, chiamare GetString() per ottenere il token di stringa JSON.

Poiché questa proprietà restituisce i byte non elaborati, evitare di usarla per il confronto di testo. Chiamare ValueTextEquals invece il testo se necessario.