Utf8JsonReader.ValueSpan Propiedad

Definición

Espacio de nombres:

System.Text.Json

Ensamblado:

System.Text.Json.dll

Paquete:

System.Text.Json v9.0.0-rc.2.24473.5

Source:

Utf8JsonReader.cs

Obtiene el valor sin procesar del último token procesado como un segmento ReadOnlySpan<byte> de la carga de entrada, si el token se adapta a un único segmento o si el lector se construyó con una carga JSON contenida en 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)

Valor de propiedad

ReadOnlySpan<Byte>

Un intervalo de bytes de solo lectura.

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 true, ValueSpan está vacío. Por lo tanto, solo tiene acceso ValueSpan si HasValueSequence es false. De lo contrario, se debe tener acceso al valor del token desde ValueSequence.

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 desencapse el texto si es necesario.