Utf8JsonReader Estructura

Referencia

Definición

Espacio de nombres:: System.Text.Json

Ensamblado:: System.Text.Json.dll

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í.

Proporciona una API de alto rendimiento para acceso de solo avance y solo lectura a texto JSON con codificación UTF-8.

public value class Utf8JsonReader

public ref struct Utf8JsonReader

type Utf8JsonReader = struct

Public Structure Utf8JsonReader

Herencia: Object

ValueType
Utf8JsonReader

Comentarios

Utf8JsonReader procesa el texto secuencialmente sin almacenamiento en caché y, de forma predeterminada, se adhiere estrictamente a la RFC JSON.

Cuando Utf8JsonReader encuentra JSON no válido, produce un JsonException con información de error básica, como el número de línea y la posición de bytes en la línea.

Dado que este tipo es una estructura de referencia, no admite directamente async. Sin embargo, proporciona compatibilidad con la reentrada para leer datos incompletos y continuar leyendo una vez más datos.

Para poder establecer la profundidad máxima mientras lee O permite omitir comentarios, cree una instancia de JsonReaderOptions y pásela al lector.

Para obtener más información, vea Cómo escribir serializadores y deserializadores personalizados con System.Text.Json.

Constructores

Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState)	Inicializa una nueva instancia de la estructura Utf8JsonReader que procesa una secuencia de solo lectura de texto con codificación UTF-8 e indica si la entrada contiene todo el texto que se va a procesar.
Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions)	Inicializa una nueva instancia de la estructura Utf8JsonReader que procesa una secuencia de solo lectura de texto con codificación UTF-8 mediante las opciones especificadas.
Utf8JsonReader(ReadOnlySpan<Byte>, Boolean, JsonReaderState)	Inicializa una nueva instancia de la estructura Utf8JsonReader que procesa un intervalo de solo lectura de texto con codificación UTF-8 e indica si la entrada contiene todo el texto que se va a procesar.
Utf8JsonReader(ReadOnlySpan<Byte>, JsonReaderOptions)	Inicializa una nueva instancia de la estructura Utf8JsonReader que procesa un intervalo de solo lectura de texto con codificación UTF-8 mediante las opciones especificadas.

Propiedades

BytesConsumed	Obtiene el número total de bytes consumidos hasta ahora por esta instancia del Utf8JsonReader.
CurrentDepth	Obtiene la profundidad del token actual.
CurrentState	Obtiene el estado actual del Utf8JsonReader que se va a pasar a un constructor del Utf8JsonReader con más datos.
HasValueSequence	Obtiene un valor que indica qué propiedad `Value` se va a usar para obtener el valor del token.
IsFinalBlock	Obtiene el modo de esta instancia de Utf8JsonReader, que indica si se han proporcionado todos los datos JSON o si hay más datos por venir.
Position	Obtiene el valor SequencePosition actual dentro del ReadOnlySequence<byte> de entrada con codificación UTF-8 proporcionado, o bien un valor SequencePosition predeterminado si la estructura Utf8JsonReader se ha construido con un ReadOnlySpan<byte>.
TokenStartIndex	Obtiene el índice en el que comienza el último token JSON procesado (dentro del texto de entrada codificado en UTF-8 proporcionado), y omite los espacios en blanco.
TokenType	Obtiene el tipo del último token de JSON procesado en el texto JSON con codificación UTF-8.
ValueIsEscaped	Obtiene un valor que indica si las propiedades o ValueSequence actuales ValueSpan contienen secuencias de escape por la sección 7 de RFC 8259 y, por tanto, requieren uncaping antes de consumirse.
ValueSequence	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.
ValueSpan	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>.

Métodos

CopyString(Span<Byte>)	Copia el valor del token JSON actual del origen, sin escape como una cadena UTF-8 en el búfer de destino.
CopyString(Span<Char>)	Copia el valor del token JSON actual del origen, sin escape y transcodificado como un búfer de caracteres UTF-16.
GetBoolean()	Lee el valor del token de JSON siguiente del origen como un valor Boolean.
GetByte()	Analiza el valor del token JSON actual del origen como un Byte.
GetBytesFromBase64()	Analiza el valor del token JSON actual del origen y descodifica la cadena JSON con codificación Base64 como una matriz de bytes.
GetComment()	Analiza el valor del token JSON actual del origen como comentario, transcodificado como String.
GetDateTime()	Lee el valor del token de JSON siguiente del origen y lo analiza en DateTime.
GetDateTimeOffset()	Lee el valor del token de JSON siguiente del origen y lo analiza en DateTimeOffset.
GetDecimal()	Lee el valor del token de JSON siguiente del origen y lo analiza en Decimal.
GetDouble()	Lee el valor del token de JSON siguiente del origen y lo analiza en Double.
GetGuid()	Lee el valor del token de JSON siguiente del origen y lo analiza en Guid.
GetInt16()	Analiza el valor del token JSON actual del origen como un Int16.
GetInt32()	Lee el valor del token de JSON siguiente del origen y lo analiza en Int32.
GetInt64()	Lee el valor del token de JSON siguiente del origen y lo analiza en Int64.
GetSByte()	Analiza el valor del token JSON actual del origen como un SByte.
GetSingle()	Lee el valor del token de JSON siguiente del origen y lo analiza en Single.
GetString()	Lee el valor del token JSON siguiente del origen, sin escape, y transcodificado como una cadena.
GetUInt16()	Analiza el valor del token JSON actual del origen como un UInt16.
GetUInt32()	Lee el valor del token de JSON siguiente del origen y lo analiza en UInt32.
GetUInt64()	Lee el valor del token de JSON siguiente del origen y lo analiza en UInt64.
Read()	Lee el token JSON siguiente del origen de entrada.
Skip()	Omite los elementos secundarios del token JSON actual.
TryGetByte(Byte)	Intenta analizar el valor del token JSON actual del origen como Byte y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetBytesFromBase64(Byte[])	Intenta analizar el valor del token JSON actual del origen, descodifica la cadena JSON con codificación Base64 como una matriz de bytes y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetDateTime(DateTime)	Intenta analizar el valor del token JSON actual del origen como DateTime y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetDateTimeOffset(DateTimeOffset)	Intenta analizar el valor del token JSON actual del origen como DateTimeOffset y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetDecimal(Decimal)	Intenta analizar el valor del token JSON actual del origen como Decimal y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetDouble(Double)	Intenta analizar el valor del token JSON actual del origen como Double y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetGuid(Guid)	Intenta analizar el valor del token JSON actual del origen como Guid y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetInt16(Int16)	Intenta analizar el valor del token JSON actual del origen como Int16 y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetInt32(Int32)	Intenta analizar el valor del token JSON actual del origen como Int32 y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetInt64(Int64)	Intenta analizar el valor del token JSON actual del origen como Int64 y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetSByte(SByte)	Intenta analizar el valor del token JSON actual del origen como SByte y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetSingle(Single)	Intenta analizar el valor del token JSON actual del origen como Single y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetUInt16(UInt16)	Intenta analizar el valor del token JSON actual del origen como UInt16 y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetUInt32(UInt32)	Intenta analizar el valor del token JSON actual del origen como UInt32 y devuelve un valor que indica si la operación se ha realizado correctamente.
TryGetUInt64(UInt64)	Intenta analizar el valor del token JSON actual del origen como UInt64 y devuelve un valor que indica si la operación se ha realizado correctamente.
TrySkip()	Intenta omitir los elementos secundarios del token JSON actual.
ValueTextEquals(ReadOnlySpan<Byte>)	Compara el texto con codificación UTF-8 de un intervalo de bytes de solo lectura con el valor del token JSON sin escape del origen y devuelve un valor que indica si coinciden.
ValueTextEquals(ReadOnlySpan<Char>)	Compara el texto de un intervalo de caracteres de solo lectura con el valor del token JSON sin escape del origen y devuelve un valor que indica si coinciden.
ValueTextEquals(String)	Compara el texto de cadena con el valor del token JSON sin escape del origen y devuelve un valor que indica si coinciden.

Se aplica a