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.Provides a high-performance API for forward-only, read-only access to UTF-8 encoded JSON text.

public value class Utf8JsonReader
public 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 de JSON.Utf8JsonReader processes the text sequentially with no caching and by default adheres strictly to the JSON RFC.

Cuando Utf8JsonReader encuentra JSON no válido, produce una JsonException con información de error básica como el número de línea y la posición de byte en la línea.When Utf8JsonReader encounters invalid JSON, it throws a JsonException with basic error information like line number and byte position on the line.

Dado que este tipo es un struct de referencia, no es compatible directamente con Async.Since this type is a ref struct, it doesn't directly support async. Sin embargo, proporciona compatibilidad con la reentrada para leer datos incompletos y seguir leyendo una vez que se presentan más datos.However, it does provide support for reentrancy to read incomplete data and to continue reading once more data is presented.

Para poder establecer la profundidad máxima mientras lee o permite omitir los comentarios, cree una instancia de JsonReaderOptions y páselo al lector.To be able to set max depth while reading OR allow skipping comments, create an instance of JsonReaderOptions and pass it to the reader.

Para obtener más información, vea Cómo serializar y deserializar JSON.For more information, see How to serialize and deserialize 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.Initializes a new instance of the Utf8JsonReader structure that processes a read-only sequence of UTF-8 encoded text and indicates whether the input contains all the text to process.

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.Initializes a new instance of the Utf8JsonReader structure that processes a read-only sequence of UTF-8 encoded text using the specified options.

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.Initializes a new instance of the Utf8JsonReader structure that processes a read-only span of UTF-8 encoded text and indicates whether the input contains all the text to process.

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.Initializes a new instance of the Utf8JsonReader structure that processes a read-only span of UTF-8 encoded text using the specified options.

Propiedades

BytesConsumed

Obtiene el número total de bytes consumidos hasta ahora por esta instancia del Utf8JsonReader.Gets the total number of bytes consumed so far by this instance of the Utf8JsonReader.

CurrentDepth

Obtiene la profundidad del token actual.Gets the depth of the current token.

CurrentState

Obtiene el estado actual del Utf8JsonReader que se va a pasar a un constructor del Utf8JsonReader con más datos.Gets the current Utf8JsonReader state to pass to a Utf8JsonReader constructor with more data.

HasValueSequence

Obtiene un valor que indica qué propiedad Value se va a usar para obtener el valor del token.Gets a value that indicates which Value property to use to get the token value.

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.Gets the mode of this instance of the Utf8JsonReader which indicates whether all the JSON data was provided or there is more data to come.

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>.Gets the current SequencePosition within the provided UTF-8 encoded input ReadOnlySequence<byte> or a default SequencePosition if the Utf8JsonReader struct was constructed with a 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.Gets the index that the last processed JSON token starts at (within the given UTF-8 encoded input text), skipping any white space.

TokenType

Obtiene el tipo del último token de JSON procesado en el texto JSON con codificación UTF-8.Gets the type of the last processed JSON token in the UTF-8 encoded JSON text.

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.Gets the raw value of the last processed token as a ReadOnlySequence<byte> slice of the input payload, only if the token is contained within multiple segments.

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>.Gets the raw value of the last processed token as a ReadOnlySpan<byte> slice of the input payload, if the token fits in a single segment or if the reader was constructed with a JSON payload contained in a ReadOnlySpan<byte>.

Métodos

GetBoolean()

Lee el valor del token de JSON siguiente del origen como un valor Boolean.Reads the next JSON token value from the source as a Boolean.

GetByte()

Analiza el valor del token JSON actual del origen como un Byte.Parses the current JSON token value from the source as a 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.Parses the current JSON token value from the source and decodes the Base64 encoded JSON string as a byte array.

GetComment()

Analiza el valor del token JSON actual del origen como comentario, transcodificado como String.Parses the current JSON token value from the source as a comment, transcoded it as a String.

GetDateTime()

Lee el valor del token de JSON siguiente del origen y lo analiza en DateTime.Reads the next JSON token value from the source and parses it to a DateTime.

GetDateTimeOffset()

Lee el valor del token de JSON siguiente del origen y lo analiza en DateTimeOffset.Reads the next JSON token value from the source and parses it to a DateTimeOffset.

GetDecimal()

Lee el valor del token de JSON siguiente del origen y lo analiza en Decimal.Reads the next JSON token value from the source and parses it to a Decimal.

GetDouble()

Lee el valor del token de JSON siguiente del origen y lo analiza en Double.Reads the next JSON token value from the source and parses it to a Double.

GetGuid()

Lee el valor del token de JSON siguiente del origen y lo analiza en Guid.Reads the next JSON token value from the source and parses it to a Guid.

GetInt16()

Analiza el valor del token JSON actual del origen como un Int16.Parses the current JSON token value from the source as a Int16.

GetInt32()

Lee el valor del token de JSON siguiente del origen y lo analiza en Int32.Reads the next JSON token value from the source and parses it to an Int32.

GetInt64()

Lee el valor del token de JSON siguiente del origen y lo analiza en Int64.Reads the next JSON token value from the source and parses it to an Int64.

GetSByte()

Analiza el valor del token JSON actual del origen como un SByte.Parses the current JSON token value from the source as an SByte.

GetSingle()

Lee el valor del token de JSON siguiente del origen y lo analiza en Single.Reads the next JSON token value from the source and parses it to a Single.

GetString()

Lee el valor del token JSON siguiente del origen, sin escape, y transcodificado como una cadena.Reads the next JSON token value from the source, unescaped, and transcoded as a string.

GetUInt16()

Analiza el valor del token JSON actual del origen como un UInt16.Parses the current JSON token value from the source as a UInt16.

GetUInt32()

Lee el valor del token de JSON siguiente del origen y lo analiza en UInt32.Reads the next JSON token value from the source and parses it to a UInt32.

GetUInt64()

Lee el valor del token de JSON siguiente del origen y lo analiza en UInt64.Reads the next JSON token value from the source and parses it to a UInt64.

Read()

Lee el token JSON siguiente del origen de entrada.Reads the next JSON token from the input source.

Skip()

Omite los elementos secundarios del token JSON actual.Skips the children of the current JSON token.

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.Tries to parse the current JSON token value from the source as a Byte and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source and decodes the Base64 encoded JSON string as a byte array and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as a DateTime and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as a DateTimeOffset and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as a Decimal and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as a Double and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as a Guid and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as an Int16 and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as an Int32 and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as an Int64 and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as an SByte and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as a Single and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as a UInt16 and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as a UInt32 and returns a value that indicates whether the operation succeeded.

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.Tries to parse the current JSON token value from the source as a UInt64 and returns a value that indicates whether the operation succeeded.

TrySkip()

Intenta omitir los elementos secundarios del token JSON actual.Tries to skip the children of the current JSON token.

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.Compares the UTF-8 encoded text in a read-only byte span to the unescaped JSON token value in the source and returns a value that indicates whether they match.

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.Compares the text in a read-only character span to the unescaped JSON token value in the source and returns a value that indicates whether they match.

ValueTextEquals(String)

Compara el texto de la cadena con el valor del token JSON sin escape del origen y devuelve un valor que indica si coinciden.Compares the string text to the unescaped JSON token value in the source and returns a value that indicates whether they match.

Se aplica a