Utf8JsonReader.ValueSequence Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene el valor sin procesar del último token procesado como un segmento ReadOnlySequence<byte> de la carga de entrada, solo si el token está contenido en muchos segmentos.
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)
Valor de propiedad
Secuencia de solo lectura de bytes.
Comentarios
Si el código JSON se proporciona dentro de un valor ReadOnlySequence<byte> y el segmento que representa el valor del token se ajusta en un único segmento, ValueSpan contiene el valor segmentado, ya que se puede representar como un intervalo. De lo contrario, ValueSequence
contiene el valor del token.
Si HasValueSequence es false
, ValueSequence
está vacío. Por lo tanto, solo tiene acceso ValueSequence
si HasValueSequence es true
.
De lo contrario, se debe tener acceso al valor del token desde ValueSpan.
No hay ninguna garantía de que esta propiedad siempre contendrá datos bien formados. Si el JSON de entrada pasado a Utf8JsonReader
contiene bytes UTF-8 no válidos dentro de los tokens de cadena JSON, esta propiedad devolverá esos bytes UTF-8 no válidos tal cual.
Por lo tanto, si la entrada no es de confianza o no se valida previamente, llame GetString() a para obtener el token de cadena JSON.
Puesto que esta propiedad devuelve los bytes sin procesar, evite usarlo para la comparación de texto. En su lugar, llame a ValueTextEquals, que quita el texto si es necesario.