Utf8JsonReader.ValueSpan Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene il valore non elaborato dell'ultimo token elaborato come sezione di byte ReadOnlySpan<del payload di input, se il token rientra in un singolo segmento o se il lettore è stato costruito con un payload JSON contenuto in un byte> ReadOnlySpan<.>
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à
Intervallo di byte di sola lettura.
Commenti
Se il codice JSON viene fornito all'interno di un byte> ReadOnlySequence<e la sezione che rappresenta il valore del token rientra in un singolo segmento, ValueSpan contiene il valore sezionato perché può essere rappresentato come intervallo. In caso contrario, ValueSequence contiene il valore del token.
Se HasValueSequence è , ValueSpan è truevuoto.
Di conseguenza, l'accesso è ValueSpan solo se HasValueSequence è false.
In caso contrario, è necessario accedere al valore del token da ValueSequence.
Non esiste alcuna garanzia che questa proprietà conterrà sempre dati ben formati. Se il codice JSON di input passato a Utf8JsonReader contiene byte UTF-8 non validi all'interno di token stringa JSON, questa proprietà restituirà i byte UTF-8 non validi così come sono.
Pertanto, se l'input non è attendibile o non è stato 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 senza caratteri di escape, se necessario.