Utf8JsonWriter Clase

Definición

Espacio de nombres:

System.Text.Json

Ensamblado:

System.Text.Json.dll

Source:

Utf8JsonWriter.cs

Proporciona una API de alto rendimiento para la escritura de solo avance sin almacenamiento en caché de texto JSON con codificación UTF-8.

public ref class Utf8JsonWriter sealed : IAsyncDisposable, IDisposable

public sealed class Utf8JsonWriter : IAsyncDisposable, IDisposable

type Utf8JsonWriter = class
    interface IAsyncDisposable
    interface IDisposable

Public NotInheritable Class Utf8JsonWriter
Implements IAsyncDisposable, IDisposable

Herencia

Object

Utf8JsonWriter

Implementaciones

IAsyncDisposable IDisposable

Comentarios

Utf8JsonWriter escribe el texto secuencialmente sin almacenamiento en caché y, de forma predeterminada, se adhiere a la RFC JSON, a excepción de escribir comentarios.

Un método que intenta escribir JSON no válido cuando la validación está habilitada produce un InvalidOperationException con un mensaje de error específico del contexto.

Para poder dar formato a la salida con sangría y espacio en blanco, para omitir la validación, O para personalizar el comportamiento de escape, cree una instancia de JsonWriterOptions y pásela al escritor.

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

Constructores

Utf8JsonWriter(IBufferWriter<Byte>, JsonWriterOptions)	Inicializa una nueva instancia de la clase Utf8JsonWriter mediante el IBufferWriter<T> especificado para escribir la salida y las opciones de personalización.
Utf8JsonWriter(Stream, JsonWriterOptions)	Inicializa una nueva instancia de la clase Utf8JsonWriter mediante el flujo especificado para escribir la salida y las opciones de personalización.

Propiedades

BytesCommitted	Obtiene el número total de bytes confirmados en la salida por la instancia actual hasta el momento.
BytesPending	Obtiene el número de bytes escritos por el objeto Utf8JsonWriter hasta el momento que aún no se han vaciado en la salida y confirmado.
CurrentDepth	Obtiene la profundidad del token actual.
Options	Obtiene el comportamiento personalizado al escribir JSON con esta instancia, lo que indica si se debe dar formato a la salida mientras se escribe, si se debe omitir la validación JSON estructural y qué caracteres se deben escapar.

Métodos

Dispose()	Confirma el texto JSON restante que aún no se ha vaciado y libera todos los recursos utilizados por la instancia actual.
DisposeAsync()	Confirma asincrónicamente el texto JSON restante que aún no se ha vaciado y libera todos los recursos utilizados por la instancia actual.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Flush()	Confirma el texto JSON escrito hasta el momento, lo que hace que sea visible en el destino de salida.
FlushAsync(CancellationToken)	Confirma asincrónicamente el texto JSON escrito hasta el momento, lo que hace que sea visible en el destino de salida.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Reset()	Restablece el estado interno de esta instancia para que se pueda reutilizar.
Reset(IBufferWriter<Byte>)	Restablece el estado interno de esta instancia para que se pueda reutilizar con una nueva instancia de IBufferWriter<T>.
Reset(Stream)	Restablece el estado interno de esta instancia para que se pueda reutilizar con una nueva instancia de Stream.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
WriteBase64String(JsonEncodedText, ReadOnlySpan<Byte>)	Escribe el nombre de la propiedad y el valor de bytes sin procesar codificados previamente (como una cadena JSON codificada en Base64) como parte de un par nombre-valor de un objeto JSON.
WriteBase64String(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Escribe el nombre de la propiedad y el valor de bytes sin procesar (como cadena JSON codificada en base 64) como parte de un par nombre-valor de un objeto JSON.
WriteBase64String(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Escribe el nombre de la propiedad y el valor de bytes sin procesar (como cadena JSON codificada en base 64) como parte de un par nombre-valor de un objeto JSON.
WriteBase64String(String, ReadOnlySpan<Byte>)	Escribe el nombre de la propiedad y el valor de bytes sin procesar (como cadena JSON codificada en base 64) como parte de un par nombre-valor de un objeto JSON.
WriteBase64StringValue(ReadOnlySpan<Byte>)	Escribe el valor de bytes sin procesar como una cadena JSON codificada en Base64 como un elemento de una matriz JSON.
WriteBoolean(JsonEncodedText, Boolean)	Escribe el nombre de la propiedad y el valor Boolean codificados previamente (como literal JSON true o false) como parte de un par nombre-valor de un objeto JSON.
WriteBoolean(ReadOnlySpan<Byte>, Boolean)	Escribe el nombre de una propiedad especificado como intervalo de bytes de solo lectura y el valor Boolean (como literal JSON true o false) como parte de un par nombre-valor de un objeto JSON.
WriteBoolean(ReadOnlySpan<Char>, Boolean)	Escribe el nombre de una propiedad especificado como intervalo de caracteres de solo lectura y el valor Boolean (como literal JSON true o false) como parte de un par nombre-valor de un objeto JSON.
WriteBoolean(String, Boolean)	Escribe el nombre de una propiedad especificado como cadena y el valor Boolean (como literal JSON true o false) como parte de un par nombre-valor de un objeto JSON.
WriteBooleanValue(Boolean)	Escribe un valor Boolean (como literal JSON true o false) como elemento de una matriz JSON.
WriteCommentValue(ReadOnlySpan<Byte>)	Escribe el valor de texto UTF-8 como comentario JSON.
WriteCommentValue(ReadOnlySpan<Char>)	Escribe el valor de texto UTF-16 como comentario JSON.
WriteCommentValue(String)	Escribe el valor de texto de cadena como comentario JSON.
WriteEndArray()	Escribe el final de una matriz de JSON.
WriteEndObject()	Escribe el final de un objeto de JSON.
WriteNull(JsonEncodedText)	Escribe el nombre de propiedad y el literal JSON null codificados previamente como parte de un par nombre-valor de un objeto JSON.
WriteNull(ReadOnlySpan<Byte>)	Escribe el nombre de una propiedad especificado como intervalo de bytes de solo lectura y el literal JSON null como parte de un par nombre-valor de un objeto JSON.
WriteNull(ReadOnlySpan<Char>)	Escribe el nombre de una propiedad especificado como intervalo de caracteres de solo lectura y el literal JSON null como parte de un par nombre-valor de un objeto JSON.
WriteNull(String)	Escribe el nombre de una propiedad especificado como cadena y el literal JSON null como parte de un par nombre-valor de un objeto JSON.
WriteNullValue()	Escribe el literal JSON NULL como un elemento de una matriz JSON.
WriteNumber(JsonEncodedText, Decimal)	Escribe el nombre de propiedad y el valor Decimal codificados previamente (como número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(JsonEncodedText, Double)	Escribe el nombre de propiedad y el valor Double codificados previamente (como número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(JsonEncodedText, Int32)	Escribe el nombre de propiedad y el valor Int32 codificados previamente (como número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(JsonEncodedText, Int64)	Escribe el nombre de propiedad y el valor Int64 codificados previamente (como número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(JsonEncodedText, Single)	Escribe el nombre de propiedad y el valor Single codificados previamente (como número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(JsonEncodedText, UInt32)	Escribe el nombre de propiedad y el valor UInt32 codificados previamente (como número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(JsonEncodedText, UInt64)	Escribe el nombre de propiedad y el valor UInt64 codificados previamente (como número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Decimal)	Escribe el nombre de propiedad especificado como intervalo de bytes de solo lectura y el valor Decimal (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Double)	Escribe el nombre de propiedad especificado como intervalo de bytes de solo lectura y el valor Double (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Int32)	Escribe el nombre de propiedad especificado como intervalo de bytes de solo lectura y el valor Int32 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Int64)	Escribe el nombre de propiedad especificado como intervalo de bytes de solo lectura y el valor Int64 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Single)	Escribe el nombre de propiedad especificado como intervalo de bytes de solo lectura y el valor Single (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, UInt32)	Escribe el nombre de propiedad especificado como intervalo de bytes de solo lectura y el valor UInt32 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, UInt64)	Escribe el nombre de propiedad especificado como intervalo de bytes de solo lectura y el valor UInt64 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Decimal)	Escribe el nombre de propiedad especificado como intervalo de caracteres de solo lectura y el valor Decimal (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Double)	Escribe el nombre de propiedad especificado como intervalo de caracteres de solo lectura y el valor Double (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Int32)	Escribe el nombre de propiedad especificado como intervalo de caracteres de solo lectura y el valor Int32 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Int64)	Escribe el nombre de propiedad especificado como intervalo de caracteres de solo lectura y el valor Int64 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Single)	Escribe el nombre de propiedad especificado como intervalo de caracteres de solo lectura y el valor Single (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Char>, UInt32)	Escribe el nombre de propiedad especificado como intervalo de caracteres de solo lectura y el valor UInt32 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(ReadOnlySpan<Char>, UInt64)	Escribe el nombre de propiedad especificado como intervalo de caracteres de solo lectura y el valor UInt64 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(String, Decimal)	Escribe el nombre de propiedad especificado como cadena y el valor Decimal (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(String, Double)	Escribe el nombre de propiedad especificado como cadena y el valor Double (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(String, Int32)	Escribe el nombre de propiedad especificado como cadena y el valor Int32 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(String, Int64)	Escribe el nombre de propiedad especificado como cadena y el valor Int64 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(String, Single)	Escribe el nombre de propiedad especificado como cadena y el valor Single (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(String, UInt32)	Escribe el nombre de propiedad especificado como cadena y el valor UInt32 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumber(String, UInt64)	Escribe el nombre de propiedad especificado como cadena y el valor UInt64 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.
WriteNumberValue(Decimal)	Escribe el valor Decimal (como un número JSON) como elemento de una matriz JSON.
WriteNumberValue(Double)	Escribe el valor Double (como un número JSON) como elemento de una matriz JSON.
WriteNumberValue(Int32)	Escribe el valor Int32 (como un número JSON) como elemento de una matriz JSON.
WriteNumberValue(Int64)	Escribe el valor Int64 (como un número JSON) como elemento de una matriz JSON.
WriteNumberValue(Single)	Escribe el valor Single (como un número JSON) como elemento de una matriz JSON.
WriteNumberValue(UInt32)	Escribe el valor UInt32 (como un número JSON) como elemento de una matriz JSON.
WriteNumberValue(UInt64)	Escribe el valor UInt64 (como un número JSON) como elemento de una matriz JSON.
WritePropertyName(JsonEncodedText)	Escribe el nombre de propiedad codificado previamente (como cadena JSON) como primera parte de un par nombre-valor de un objeto JSON.
WritePropertyName(ReadOnlySpan<Byte>)	Escribe el nombre de propiedad UTF-8 (como una cadena JSON) como primera parte de un par nombre-valor de un objeto JSON.
WritePropertyName(ReadOnlySpan<Char>)	Escribe el nombre de propiedad (como una cadena JSON) como primera parte de un par nombre-valor de un objeto JSON.
WritePropertyName(String)	Escribe el nombre de propiedad (como una cadena JSON) como primera parte de un par nombre-valor de un objeto JSON.
WriteRawValue(ReadOnlySequence<Byte>, Boolean)	Escribe la entrada como contenido JSON. Se espera que el contenido de entrada sea un único valor JSON completo.
WriteRawValue(ReadOnlySpan<Byte>, Boolean)	Escribe la entrada como contenido JSON. Se espera que el contenido de entrada sea un único valor JSON completo.
WriteRawValue(ReadOnlySpan<Char>, Boolean)	Escribe la entrada como contenido JSON. Se espera que el contenido de entrada sea un único valor JSON completo.
WriteRawValue(String, Boolean)	Escribe la entrada como contenido JSON. Se espera que el contenido de entrada sea un único valor JSON completo.
WriteStartArray()	Escribe el principio de una matriz de JSON.
WriteStartArray(JsonEncodedText)	Escribe el principio de una matriz JSON con un nombre de propiedad codificado previamente como clave.
WriteStartArray(ReadOnlySpan<Byte>)	Escribe el principio de una matriz JSON con un nombre de propiedad especificado como intervalo de bytes de solo lectura como la clave.
WriteStartArray(ReadOnlySpan<Char>)	Escribe el principio de una matriz JSON con un nombre de propiedad especificado como intervalo de caracteres de solo lectura como la clave.
WriteStartArray(String)	Escribe el principio de una matriz JSON con un nombre de propiedad especificado como cadena como la clave.
WriteStartObject()	Escribe el principio de un objeto de JSON.
WriteStartObject(JsonEncodedText)	Escribe el principio de un objeto JSON con un nombre de propiedad codificado previamente como clave.
WriteStartObject(ReadOnlySpan<Byte>)	Escribe el principio de un objeto JSON con un nombre de propiedad especificado como intervalo de bytes de solo lectura como la clave.
WriteStartObject(ReadOnlySpan<Char>)	Escribe el principio de un objeto JSON con un nombre de propiedad especificado como intervalo de caracteres de solo lectura como clave.
WriteStartObject(String)	Escribe el principio de un objeto JSON con un nombre de propiedad especificado como cadena como la clave.
WriteString(JsonEncodedText, DateTime)	Escribe el nombre de propiedad y el valor DateTime codificados previamente (como cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(JsonEncodedText, DateTimeOffset)	Escribe el nombre de propiedad y el valor DateTimeOffset codificados previamente (como cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(JsonEncodedText, Guid)	Escribe el nombre de propiedad y el valor Guid codificados previamente (como cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(JsonEncodedText, JsonEncodedText)	Escribe el nombre de propiedad y el valor codificado previamente (como cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)	Escribe el nombre de propiedad y el valor de texto UTF-8 codificados previamente (como cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(JsonEncodedText, ReadOnlySpan<Char>)	Escribe el nombre de propiedad y el valor de texto codificados previamente (como cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(JsonEncodedText, String)	Escribe el nombre de propiedad y el valor de texto de cadena codificados previamente (como cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Byte>, DateTime)	Escribe el nombre de propiedad UTF-8 y el valor DateTime (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)	Escribe el nombre de propiedad UTF-8 y el valor DateTimeOffset (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Byte>, Guid)	Escribe el nombre de propiedad UTF-8 y el valor Guid (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Byte>, JsonEncodedText)	Escribe el nombre de propiedad UTF-8 y el valor codificado previamente (como cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Escribe el nombre de propiedad UTF-8 y el valor de texto UTF-8 (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)	Escribe el nombre de propiedad UTF-8 y el valor de texto UTF-16 (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Byte>, String)	Escribe el nombre de propiedad UTF-8 y el valor de texto de cadena (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Char>, DateTime)	Escribe el nombre de propiedad especificado como intervalo de caracteres de solo lectura y el valor DateTime (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Char>, DateTimeOffset)	Escribe el nombre de propiedad especificado como intervalo de caracteres de solo lectura y el valor DateTimeOffset (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Char>, Guid)	Escribe el nombre de propiedad especificado como intervalo de caracteres de solo lectura y el valor Guid (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Char>, JsonEncodedText)	Escribe el nombre de propiedad y el valor codificado previamente (como cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Escribe el nombre de propiedad UTF-16 y el valor de texto UTF-8 (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Escribe el nombre de propiedad UTF-16 y el valor de texto UTF-16 (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(ReadOnlySpan<Char>, String)	Escribe el nombre de propiedad UTF-16 y el valor de texto de cadena (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(String, DateTime)	Escribe el nombre de propiedad especificado como cadena y el valor DateTime (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(String, DateTimeOffset)	Escribe el nombre de propiedad especificado como cadena y el valor DateTimeOffset (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(String, Guid)	Escribe el nombre de propiedad especificado como cadena y el valor Guid (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(String, JsonEncodedText)	Escribe el nombre de propiedad y el valor codificado previamente (como cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(String, ReadOnlySpan<Byte>)	Escribe el nombre de propiedad especificado como cadena y el valor de texto UTF-8 (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(String, ReadOnlySpan<Char>)	Escribe el nombre de propiedad especificado como cadena y el valor de texto UTF-16 (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteString(String, String)	Escribe el nombre de propiedad especificado como cadena y el valor de texto de cadena (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.
WriteStringValue(DateTime)	Escribe el valor DateTime (como una cadena JSON) como elemento de una matriz JSON.
WriteStringValue(DateTimeOffset)	Escribe el valor DateTimeOffset (como una cadena JSON) como elemento de una matriz JSON.
WriteStringValue(Guid)	Escribe el valor Guid (como una cadena JSON) como elemento de una matriz JSON.
WriteStringValue(JsonEncodedText)	Escribe el valor de texto codificado previamente (como cadena JSON) como elemento de una matriz JSON.
WriteStringValue(ReadOnlySpan<Byte>)	Escribe el valor de texto UTF-8 (como una cadena JSON) como elemento de una matriz JSON.
WriteStringValue(ReadOnlySpan<Char>)	Escribe el valor de texto UTF-16 (como una cadena JSON) como elemento de una matriz JSON.
WriteStringValue(String)	Escribe el valor de texto de cadena (como una cadena JSON) como elemento de una matriz JSON.

Métodos de extensión

ConfigureAwait(IAsyncDisposable, Boolean)

Configura la forma en la que se realizan las expresiones await en las tareas devueltas desde un elemento asincrónico descartable.