Utf8JsonReader.ValueSequence Proprietà

Definizione

Spazio dei nomi:

System.Text.Json

Assembly:

System.Text.Json.dll

Ottiene il valore non elaborato dell'ultimo token elaborato come sezione di ReadOnlySequence<byte> del payload di input, solo se il token è contenuto in diversi segmenti.

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)

Valore della proprietà

ReadOnlySequence<Byte>

Sequenza 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 è , ValueSequence è falsevuoto. Pertanto, solo l'accesso ValueSequence se HasValueSequence è true. In caso contrario, il valore del token deve essere accessibile da ValueSpan.

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 ValueTextEqualsinvece , che annulla il panorama del testo, se necessario.