Utf8JsonReader.ValueSequence Propiedad

Definición

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

ReadOnlySequence<Byte>

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.

Se aplica a