Utf8JsonWriter Classe

Definição

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Source:

Utf8JsonWriter.cs

Fornece uma API de alto desempenho para gravação somente de encaminhamento e sem cache, de texto JSON codificado em 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

Herança

Object

Utf8JsonWriter

Implementações

IAsyncDisposable IDisposable

Comentários

Utf8JsonWriter grava o texto sequencialmente sem cache e, por padrão, segue o RFC JSON, com exceção de escrever comentários.

Um método que tenta gravar JSON inválido quando a validação está habilitada lança um InvalidOperationException com uma mensagem de erro específica de contexto.

Para poder formatar a saída com recuo e espaço em branco, para ignorar a validação, OR para personalizar o comportamento de escape, crie uma instância de JsonWriterOptions e passe-a para o gravador.

Para obter mais informações, consulte Como escrever serializadores e desserializadores personalizados com System.Text.Json.

Construtores

Utf8JsonWriter(IBufferWriter<Byte>, JsonWriterOptions)	Inicializa uma nova instância da classe Utf8JsonWriter usando o IBufferWriter<T> especificado para gravar as opções de saída e de personalização.
Utf8JsonWriter(Stream, JsonWriterOptions)	Inicializa uma nova instância da classe Utf8JsonWriter usando o fluxo especificado para gravar as opções de saída e de personalização.

Propriedades

BytesCommitted	Obtém o número total de bytes confirmados para a saída pela instância atual até o momento.
BytesPending	Obtém o número de bytes gravados pelo Utf8JsonWriter até o momento que ainda não foram liberados para a saída e confirmados.
CurrentDepth	Obtém a profundidade do token atual.
Options	Obtém o comportamento personalizado ao gravar JSON usando essa instância, que indica se a saída precisa ser formatada durante a gravação e se a validação estrutural de JSON deve ser ignorada e quais caracteres devem ser para escape.

Métodos

Dispose()	Confirma qualquer texto JSON restante que ainda não foi liberado e libera todos os recursos usados pela instância atual.
DisposeAsync()	Confirma de maneira assíncrona qualquer texto JSON restante que ainda não foi liberado e libera todos os recursos usados pela instância atual.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Flush()	Confirma o texto JSON gravado até o momento, o que o torna visível para o destino de saída.
FlushAsync(CancellationToken)	Confirma de maneira assíncrona o texto JSON escrito até o momento, o que o torna visível para o destino de saída.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Reset()	Redefine o estado interno dessa instância para que ela possa ser reutilizada.
Reset(IBufferWriter<Byte>)	Redefine o estado interno dessa instância para que ela possa ser reutilizada com uma nova instância de IBufferWriter<T>.
Reset(Stream)	Redefine o estado interno dessa instância para que ela possa ser reutilizada com uma nova instância de Stream.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
WriteBase64String(JsonEncodedText, ReadOnlySpan<Byte>)	Grava o nome da propriedade pré-codificada e o valor de bytes brutos (como uma cadeia de caracteres JSON codificada em Base64) como parte de um par nome/valor de um objeto JSON.
WriteBase64String(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Grava o nome da propriedade e o valor de bytes brutos (como uma cadeia de caracteres JSON codificada em Base64) como parte de um par nome/valor de um objeto JSON.
WriteBase64String(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Grava o nome da propriedade e o valor de bytes brutos (como uma cadeia de caracteres JSON codificada em Base64) como parte de um par nome/valor de um objeto JSON.
WriteBase64String(String, ReadOnlySpan<Byte>)	Grava o nome da propriedade e o valor de bytes brutos (como uma cadeia de caracteres JSON codificada em Base64) como parte de um par nome/valor de um objeto JSON.
WriteBase64StringValue(ReadOnlySpan<Byte>)	Grava o valor de bytes brutos como uma cadeia de caracteres JSON codificada em Base64 como um elemento de uma matriz JSON.
WriteBoolean(JsonEncodedText, Boolean)	Grava o nome da propriedade pré-codificada e o valor de Boolean (como um literal JSON true ou false) como parte de um par nome/valor de um objeto JSON.
WriteBoolean(ReadOnlySpan<Byte>, Boolean)	Grava um nome de propriedade especificado como um intervalo de bytes somente leitura a um valor de Boolean (como um literal JSON true ou false) como parte de um par nome/valor de um objeto JSON.
WriteBoolean(ReadOnlySpan<Char>, Boolean)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de Boolean (como um literal JSON true ou false) como parte de um par nome/valor de um objeto JSON.
WriteBoolean(String, Boolean)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de Boolean (como um literal JSON true ou false) como parte de um par nome/valor de um objeto JSON.
WriteBooleanValue(Boolean)	Grava um valor de Boolean (como um literal JSON true ou false) como um elemento de uma matriz JSON.
WriteCommentValue(ReadOnlySpan<Byte>)	Grava um valor de texto UTF-8 como um comentário JSON.
WriteCommentValue(ReadOnlySpan<Char>)	Grava um valor de texto UTF-16 como um comentário JSON.
WriteCommentValue(String)	Grava um valor de texto de cadeia de caracteres como um comentário JSON.
WriteEndArray()	Grava o fim de uma matriz JSON.
WriteEndObject()	Grava o fim de um objeto JSON.
WriteNull(JsonEncodedText)	Grava o nome da propriedade pré-codificada e o literal JSON null como parte de um par nome/valor de um objeto JSON.
WriteNull(ReadOnlySpan<Byte>)	Grava um nome de propriedade especificado como um intervalo de bytes somente leitura e o literal JSON null como parte de um par nome/valor de um objeto JSON.
WriteNull(ReadOnlySpan<Char>)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura e o literal JSON null como parte de um par nome/valor de um objeto JSON.
WriteNull(String)	Grava um nome de propriedade especificado como uma cadeia de caracteres e o literal JSON null como parte de um par nome/valor de um objeto JSON.
WriteNullValue()	Grava o literal JSON null como um elemento de uma matriz JSON.
WriteNumber(JsonEncodedText, Decimal)	Grava o nome da propriedade pré-codificada e o valor de Decimal (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(JsonEncodedText, Double)	Grava o nome da propriedade pré-codificada e o valor de Double (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(JsonEncodedText, Int32)	Grava o nome da propriedade pré-codificada e o valor de Int32 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(JsonEncodedText, Int64)	Grava o nome da propriedade pré-codificada e o valor de Int64 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(JsonEncodedText, Single)	Grava o nome da propriedade pré-codificada e o valor de Single (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(JsonEncodedText, UInt32)	Grava o nome da propriedade pré-codificada e o valor de UInt32 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(JsonEncodedText, UInt64)	Grava o nome da propriedade pré-codificada e o valor de UInt64 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Decimal)	Grava um nome de propriedade especificado como um intervalo de bytes somente leitura a um valor de Decimal (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Double)	Grava um nome de propriedade especificado como um intervalo de bytes somente leitura a um valor de Double (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Int32)	Grava um nome de propriedade especificado como um intervalo de bytes somente leitura a um valor de Int32 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Int64)	Grava um nome de propriedade especificado como um intervalo de bytes somente leitura a um valor de Int64 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Single)	Grava um nome de propriedade especificado como um intervalo de bytes somente leitura a um valor de Single (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, UInt32)	Grava um nome de propriedade especificado como um intervalo de bytes somente leitura a um valor de UInt32 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, UInt64)	Grava um nome de propriedade especificado como um intervalo de bytes somente leitura a um valor de UInt64 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Decimal)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de Decimal (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Double)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de Double (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Int32)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de Int32 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Int64)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de Int64 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Single)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de Single (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, UInt32)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de UInt32 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, UInt64)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de UInt64 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, Decimal)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de Decimal (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, Double)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de Double (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, Int32)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de Int32 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, Int64)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de Int64 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, Single)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de Single (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, UInt32)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de UInt32 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, UInt64)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de UInt64 (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumberValue(Decimal)	Grava um valor de Decimal (como um número JSON) como um elemento de uma matriz JSON.
WriteNumberValue(Double)	Grava um valor de Double (como um número JSON) como um elemento de uma matriz JSON.
WriteNumberValue(Int32)	Grava um valor de Int32 (como um número JSON) como um elemento de uma matriz JSON.
WriteNumberValue(Int64)	Grava um valor de Int64 (como um número JSON) como um elemento de uma matriz JSON.
WriteNumberValue(Single)	Grava um valor de Single (como um número JSON) como um elemento de uma matriz JSON.
WriteNumberValue(UInt32)	Grava um valor de UInt32 (como um número JSON) como um elemento de uma matriz JSON.
WriteNumberValue(UInt64)	Grava um valor de UInt64 (como um número JSON) como um elemento de uma matriz JSON.
WritePropertyName(JsonEncodedText)	Grava o nome da propriedade pré-codificada (como uma cadeia de caracteres JSON) como a primeira parte de um par nome/valor de um objeto JSON.
WritePropertyName(ReadOnlySpan<Byte>)	Grava o nome da propriedade UTF-8 (como uma cadeia de caracteres JSON) como a primeira parte de um par nome/valor de um objeto JSON.
WritePropertyName(ReadOnlySpan<Char>)	Grava o nome da propriedade (como uma cadeia de caracteres JSON) como a primeira parte de um par nome/valor de um objeto JSON.
WritePropertyName(String)	Grava o nome da propriedade (como uma cadeia de caracteres JSON) como a primeira parte de um par nome/valor de um objeto JSON.
WriteRawValue(ReadOnlySequence<Byte>, Boolean)	Grava a entrada como conteúdo JSON. Espera-se que o conteúdo de entrada seja um único valor JSON completo.
WriteRawValue(ReadOnlySpan<Byte>, Boolean)	Grava a entrada como conteúdo JSON. Espera-se que o conteúdo de entrada seja um único valor JSON completo.
WriteRawValue(ReadOnlySpan<Char>, Boolean)	Grava a entrada como conteúdo JSON. Espera-se que o conteúdo de entrada seja um único valor JSON completo.
WriteRawValue(String, Boolean)	Grava a entrada como conteúdo JSON. Espera-se que o conteúdo de entrada seja um único valor JSON completo.
WriteStartArray()	Grava o início de uma matriz JSON.
WriteStartArray(JsonEncodedText)	Grava o início de uma matriz JSON com um nome de propriedade pré-codificada como a chave.
WriteStartArray(ReadOnlySpan<Byte>)	Grava o início de uma matriz JSON com um nome de propriedade especificado como um intervalo de bytes somente leitura como a chave.
WriteStartArray(ReadOnlySpan<Char>)	Grava o início de uma matriz JSON com um nome de propriedade especificado como um intervalo de caracteres somente leitura como a chave.
WriteStartArray(String)	Grava o início de uma matriz JSON com um nome de propriedade especificado como uma cadeia de caracteres como a chave.
WriteStartObject()	Grava o início de um objeto JSON.
WriteStartObject(JsonEncodedText)	Grava o início de um objeto JSON com um nome de propriedade pré-codificada como a chave.
WriteStartObject(ReadOnlySpan<Byte>)	Grava o início de um objeto JSON com um nome de propriedade especificado como um intervalo de bytes somente leitura como a chave.
WriteStartObject(ReadOnlySpan<Char>)	Grava o início de um objeto JSON com um nome de propriedade especificado como um intervalo de caracteres somente leitura como a chave.
WriteStartObject(String)	Grava o início de um objeto JSON com um nome de propriedade especificado como uma cadeia de caracteres como a chave.
WriteString(JsonEncodedText, DateTime)	Grava o nome da propriedade pré-codificada e o valor de DateTime (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, DateTimeOffset)	Grava o nome da propriedade pré-codificada e o valor de DateTimeOffset (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, Guid)	Grava o nome da propriedade pré-codificada e o valor de Guid (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, JsonEncodedText)	Grava o nome da propriedade pré-codificada e o valor pré-codificado (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)	Grava o nome da propriedade pré-codificada e o valor de texto UTF-8 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, ReadOnlySpan<Char>)	Grava o nome da propriedade pré-codificada e o valor de texto (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, String)	Grava o nome da propriedade pré-codificada e o valor de texto de cadeia de caracteres (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, DateTime)	Grava o nome de uma propriedade UTF-8 e um valor de DateTime (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)	Grava o nome de uma propriedade UTF-8 e um valor de DateTimeOffset (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, Guid)	Grava o nome de uma propriedade UTF-8 e um valor de Guid (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, JsonEncodedText)	Grava o nome da propriedade UTF-8 e o valor pré-codificado (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Grava o nome de uma propriedade UTF-8 e o valor de texto UTF-8 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)	Grava o nome de uma propriedade UTF-8 e o valor de texto UTF-16 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, String)	Grava o nome de uma propriedade UTF-8 e o valor de texto de uma cadeia de caracteres (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, DateTime)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de DateTime (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, DateTimeOffset)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de DateTimeOffset (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, Guid)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de Guid (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, JsonEncodedText)	Grava o nome da propriedade e o valor pré-codificado (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Grava o nome de uma propriedade UTF-16 e o valor de texto UTF-8 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Grava o nome de uma propriedade UTF-16 e o valor de texto UTF-16 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, String)	Grava o nome de uma propriedade UTF-16 e o valor de texto de uma cadeia de caracteres (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, DateTime)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de DateTime (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, DateTimeOffset)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de DateTimeOffset (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, Guid)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de Guid (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, JsonEncodedText)	Grava o nome da propriedade e o valor pré-codificado (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, ReadOnlySpan<Byte>)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de texto UTF-8 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, ReadOnlySpan<Char>)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de texto UTF-16 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, String)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de texto de cadeia de caracteres (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteStringValue(DateTime)	Grava um valor de DateTime (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.
WriteStringValue(DateTimeOffset)	Grava um valor de DateTimeOffset (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.
WriteStringValue(Guid)	Grava um valor de Guid (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.
WriteStringValue(JsonEncodedText)	Grava o valor de texto pré-codificado (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.
WriteStringValue(ReadOnlySpan<Byte>)	Grava um valor de texto UTF-8 (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.
WriteStringValue(ReadOnlySpan<Char>)	Grava um valor de texto UTF-16 (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.
WriteStringValue(String)	Grava um valor de texto de cadeia de caracteres (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.

Métodos de Extensão

ConfigureAwait(IAsyncDisposable, Boolean)

Configura como as esperas nas tarefas retornadas de um descartável assíncrono são realizadas.