Compartir a través de


Utf8JsonReader Estructura

Definición

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