Compartir a través de


Utf8JsonWriter Clase

Definición

Proporciona una API de alto rendimiento para la escritura sin almacenamiento en caché de solo avance 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
type Utf8JsonWriter = class
    interface IDisposable
    interface IAsyncDisposable
Public NotInheritable Class Utf8JsonWriter
Implements IAsyncDisposable, IDisposable
Herencia
Utf8JsonWriter
Implementaciones

Comentarios

escribe el texto secuencialmente sin almacenamiento en caché y, de forma predeterminada, se adhiere alRFC JSON de , 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, omitir la validación o personalizar el comportamiento de escape, crear una instancia de JsonWriterOptions y pasarla 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 utilizando el IBufferWriter<T> especificado para escribir la salida en y las opciones de personalización.

Utf8JsonWriter(Stream, JsonWriterOptions)

Inicializa una nueva instancia de la clase Utf8JsonWriter mediante la secuencia especificada para escribir la salida en las opciones de personalización y .

Propiedades

BytesCommitted

Obtiene el número total de bytes confirmados en la salida por la instancia actual hasta ahora.

BytesPending

Obtiene el número de bytes escritos por el Utf8JsonWriter hasta ahora 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 mediante esta instancia, que indica si se debe dar formato a la salida mientras se escribe, si se omite la validación estructural de JSON y qué caracteres se van a escapar.

Métodos

Dispose()

Confirma cualquier texto JSON que aún no se haya vaciado y libere todos los recursos usados por la instancia actual.

DisposeAsync()

Confirma de forma asincrónica cualquier texto JSON que aún no se haya vaciado y libere todos los recursos usados por la instancia actual.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
Flush()

Confirma el texto JSON escrito hasta ahora, lo que hace que sea visible para el destino de salida.

FlushAsync(CancellationToken)

Confirma de forma asincrónica el texto JSON escrito hasta ahora, lo que hace que sea visible para el destino de salida.

GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(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 propiedad codificado previamente y el valor de bytes sin formato (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 propiedad y el valor de bytes sin formato (como una cadena JSON codificada en Base64) como parte de un par nombre-valor de un objeto JSON.

WriteBase64String(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

Escribe el nombre de propiedad y el valor de bytes sin formato (como una cadena JSON codificada en Base64) como parte de un par nombre-valor de un objeto JSON.

WriteBase64String(String, ReadOnlySpan<Byte>)

Escribe el nombre de propiedad y el valor de bytes sin formato (como una cadena JSON codificada en Base64) 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 propiedad codificado previamente y Boolean valor (como un literal JSON true o false) como parte de un par nombre-valor de un objeto JSON.

WriteBoolean(ReadOnlySpan<Byte>, Boolean)

Escribe un nombre de propiedad especificado como un intervalo de bytes de solo lectura y un valor de Boolean (como un literal JSON true o false) como parte de un par nombre-valor de un objeto JSON.

WriteBoolean(ReadOnlySpan<Char>, Boolean)

Escribe un nombre de propiedad especificado como un intervalo de caracteres de solo lectura y un valor de Boolean (como un literal JSON true o false) como parte de un par nombre-valor de un objeto JSON.

WriteBoolean(String, Boolean)

Escribe un nombre de propiedad especificado como una cadena y un valor de Boolean (como literal JSON true o false) como parte de un par nombre-valor de un objeto JSON.

WriteBooleanValue(Boolean)

Escribe un valor de Boolean (como un literal JSON true o false) como un elemento de una matriz JSON.

WriteCommentValue(ReadOnlySpan<Byte>)

Escribe un valor de texto UTF-8 como comentario JSON.

WriteCommentValue(ReadOnlySpan<Char>)

Escribe un valor de texto UTF-16 como comentario JSON.

WriteCommentValue(String)

Escribe un valor de texto de cadena como comentario JSON.

WriteEndArray()

Escribe el final de una matriz JSON.

WriteEndObject()

Escribe el final de un objeto JSON.

WriteNull(JsonEncodedText)

Escribe el nombre de propiedad codificado previamente y el literal JSON null como parte de un par nombre-valor de un objeto JSON.

WriteNull(ReadOnlySpan<Byte>)

Escribe un nombre de propiedad especificado como un 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 un nombre de propiedad especificado como un 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 un nombre de propiedad especificado como una 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 codificado previamente y Decimal valor (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(JsonEncodedText, Double)

Escribe el nombre de propiedad codificado previamente y Double valor (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(JsonEncodedText, Int32)

Escribe el nombre de propiedad codificado previamente y Int32 valor (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(JsonEncodedText, Int64)

Escribe el nombre de propiedad codificado previamente y Int64 valor (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(JsonEncodedText, Single)

Escribe el nombre de propiedad codificado previamente y Single valor (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(JsonEncodedText, UInt32)

Escribe el nombre de propiedad codificado previamente y UInt32 valor (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(JsonEncodedText, UInt64)

Escribe el nombre de propiedad codificado previamente y UInt64 valor (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Byte>, Decimal)

Escribe un nombre de propiedad especificado como un intervalo de bytes de solo lectura y un valor de Decimal (como número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Byte>, Double)

Escribe un nombre de propiedad especificado como un intervalo de bytes de solo lectura y un valor de Double (como número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Byte>, Int32)

Escribe un nombre de propiedad especificado como un intervalo de bytes de solo lectura y un valor de Int32 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Byte>, Int64)

Escribe un nombre de propiedad especificado como un intervalo de bytes de solo lectura y un valor de Int64 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Byte>, Single)

Escribe un nombre de propiedad especificado como un intervalo de bytes de solo lectura y un valor de Single (como número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Byte>, UInt32)

Escribe un nombre de propiedad especificado como un intervalo de bytes de solo lectura y un valor de UInt32 (como número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Byte>, UInt64)

Escribe un nombre de propiedad especificado como un intervalo de bytes de solo lectura y un valor de UInt64 (como número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Char>, Decimal)

Escribe un nombre de propiedad especificado como un intervalo de caracteres de solo lectura y un valor de Decimal (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Char>, Double)

Escribe un nombre de propiedad especificado como un intervalo de caracteres de solo lectura y un valor de Double (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Char>, Int32)

Escribe un nombre de propiedad especificado como un intervalo de caracteres de solo lectura y un valor de Int32 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Char>, Int64)

Escribe un nombre de propiedad especificado como un intervalo de caracteres de solo lectura y un valor de Int64 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Char>, Single)

Escribe un nombre de propiedad especificado como un intervalo de caracteres de solo lectura y un valor de Single (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Char>, UInt32)

Escribe un nombre de propiedad especificado como un intervalo de caracteres de solo lectura y un valor de UInt32 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(ReadOnlySpan<Char>, UInt64)

Escribe un nombre de propiedad especificado como un intervalo de caracteres de solo lectura y un valor de UInt64 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(String, Decimal)

Escribe un nombre de propiedad especificado como una cadena y un valor de Decimal (como número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(String, Double)

Escribe un nombre de propiedad especificado como una cadena y un valor de Double (como número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(String, Int32)

Escribe un nombre de propiedad especificado como una cadena y un valor de Int32 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(String, Int64)

Escribe un nombre de propiedad especificado como una cadena y un valor de Int64 (como un número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(String, Single)

Escribe un nombre de propiedad especificado como una cadena y un valor de Single (como número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(String, UInt32)

Escribe un nombre de propiedad especificado como una cadena y un valor de UInt32 (como número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumber(String, UInt64)

Escribe un nombre de propiedad especificado como una cadena y un valor de UInt64 (como número JSON) como parte de un par nombre-valor de un objeto JSON.

WriteNumberValue(Decimal)

Escribe un valor de Decimal (como un número JSON) como un elemento de una matriz JSON.

WriteNumberValue(Double)

Escribe un valor de Double (como un número JSON) como un elemento de una matriz JSON.

WriteNumberValue(Int32)

Escribe un valor de Int32 (como un número JSON) como un elemento de una matriz JSON.

WriteNumberValue(Int64)

Escribe un valor de Int64 (como un número JSON) como un elemento de una matriz JSON.

WriteNumberValue(Single)

Escribe un valor de Single (como un número JSON) como un elemento de una matriz JSON.

WriteNumberValue(UInt32)

Escribe un valor de UInt32 (como un número JSON) como un elemento de una matriz JSON.

WriteNumberValue(UInt64)

Escribe un valor de UInt64 (como un número JSON) como un elemento de una matriz JSON.

WritePropertyName(JsonEncodedText)

Escribe el nombre de propiedad codificado previamente (como una cadena JSON) como la 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 la primera parte de un par nombre-valor de un objeto JSON.

WritePropertyName(ReadOnlySpan<Char>)

Escribe el nombre de propiedad (como una cadena JSON) como la primera parte de un par nombre-valor de un objeto JSON.

WritePropertyName(String)

Escribe el nombre de propiedad (como una cadena JSON) como la 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 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 un intervalo de bytes de solo lectura como 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 clave.

WriteStartArray(String)

Escribe el principio de una matriz JSON con un nombre de propiedad especificado como una cadena como clave.

WriteStartObject()

Escribe el principio de un objeto 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 un intervalo de bytes de solo lectura como 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 una cadena como clave.

WriteString(JsonEncodedText, DateTime)

Escribe el nombre de propiedad codificado previamente y DateTime valor (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(JsonEncodedText, DateTimeOffset)

Escribe el nombre de propiedad codificado previamente y DateTimeOffset valor (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(JsonEncodedText, Guid)

Escribe el nombre de propiedad codificado previamente y Guid valor (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(JsonEncodedText, JsonEncodedText)

Escribe el nombre de propiedad codificado previamente y el valor codificado previamente (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

Escribe el nombre de propiedad codificado previamente y el valor de texto UTF-8 (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

Escribe el nombre de propiedad codificado previamente y el valor de texto (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(JsonEncodedText, String)

Escribe el nombre de propiedad codificado previamente y el valor de texto de cadena (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(ReadOnlySpan<Byte>, DateTime)

Escribe un nombre de propiedad UTF-8 y un valor de DateTime (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

Escribe un nombre de propiedad UTF-8 y un valor de DateTimeOffset (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(ReadOnlySpan<Byte>, Guid)

Escribe un nombre de propiedad UTF-8 y un valor de 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 una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

Escribe un nombre de propiedad UTF-8 y un 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 un nombre de propiedad UTF-8 y un 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 un nombre de propiedad UTF-8 y un 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 un nombre de propiedad especificado como un intervalo de caracteres de solo lectura y un valor de DateTime (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

Escribe un nombre de propiedad especificado como un intervalo de caracteres de solo lectura y un valor de DateTimeOffset (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(ReadOnlySpan<Char>, Guid)

Escribe un nombre de propiedad especificado como un intervalo de caracteres de solo lectura y un valor de 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 una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

Escribe un nombre de propiedad UTF-16 y un 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 un nombre de propiedad UTF-16 y un 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 un nombre de propiedad UTF-16 y un valor de texto de cadena (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(String, DateTime)

Escribe un nombre de propiedad especificado como una cadena y un valor de DateTime (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(String, DateTimeOffset)

Escribe un nombre de propiedad especificado como una cadena y un valor de DateTimeOffset (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(String, Guid)

Escribe un nombre de propiedad especificado como una cadena y un valor de 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 una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(String, ReadOnlySpan<Byte>)

Escribe un nombre de propiedad especificado como una cadena y un 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 un nombre de propiedad especificado como una cadena y un valor de texto UTF-16 (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteString(String, String)

Escribe un nombre de propiedad especificado como una cadena y un valor de texto de cadena (como una cadena JSON) como parte de un par nombre-valor de un objeto JSON.

WriteStringValue(DateTime)

Escribe un valor de DateTime (como una cadena JSON) como un elemento de una matriz JSON.

WriteStringValue(DateTimeOffset)

Escribe un valor de DateTimeOffset (como una cadena JSON) como un elemento de una matriz JSON.

WriteStringValue(Guid)

Escribe un valor de Guid (como una cadena JSON) como un elemento de una matriz JSON.

WriteStringValue(JsonEncodedText)

Escribe el valor de texto codificado previamente (como una cadena JSON) como un elemento de una matriz JSON.

WriteStringValue(ReadOnlySpan<Byte>)

Escribe un valor de texto UTF-8 (como una cadena JSON) como un elemento de una matriz JSON.

WriteStringValue(ReadOnlySpan<Char>)

Escribe un valor de texto UTF-16 (como una cadena JSON) como un elemento de una matriz JSON.

WriteStringValue(String)

Escribe un valor de texto de cadena (como una cadena JSON) como un elemento de una matriz JSON.

Métodos de extensión

ConfigureAwait(IAsyncDisposable, Boolean)

Configura cómo se realizarán las esperas en las tareas devueltas desde un descartable asincrónico.

Se aplica a