Utf8JsonWriter Classe

Definição

Espaço de Nomes:
System.Text.Json
Assemblagem:
System.Text.Json.dll
Pacote:
System.Text.Json v11.0.0-preview.4.26230.115
Origem:
Utf8JsonWriter.cs
Origem:
Utf8JsonWriter.cs
Origem:
Utf8JsonWriter.cs
Origem:
Utf8JsonWriter.cs
Origem:
Utf8JsonWriter.cs
Origem:
Utf8JsonWriter.cs
Origem:
Utf8JsonWriter.cs

Fornece uma API de alto desempenho para escrita apenas direta 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
type Utf8JsonWriter = class
    interface IDisposable
    interface IAsyncDisposable
Public NotInheritable Class Utf8JsonWriter
Implements IAsyncDisposable, IDisposable
Herança
Object
Utf8JsonWriter
Implementações
IAsyncDisposable IDisposable

Observações

Utf8JsonWriter escreve o texto sequencialmente sem cache e, por defeito, cumpre o JSON RFC, com exceção dos comentários.

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

Para poder formatar a saída com indentação e espaço em branco, para saltar a validação, OU para personalizar o comportamento de escape, criar uma instância de JsonWriterOptions e passá-la ao escritor.

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

Construtores

Name Description
Utf8JsonWriter(IBufferWriter<Byte>, JsonWriterOptions)

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

Inicializa uma nova instância da Utf8JsonWriter classe usando o fluxo especificado para escrever a saída e opções de personalização.

Propriedades

Name Description
BytesCommitted

Obtém o número total de bytes comprometidos na saída pela instância atual até agora.
BytesPending

Obtém o número de bytes escritos até Utf8JsonWriter agora que ainda não foram limpos para a saída e confirmados.
CurrentDepth

Obtém a profundidade do token atual.
Options

Obtém o comportamento personalizado ao escrever JSON usando esta instância, que indica se deve formatar a saída durante a escrita, se deve saltar a validação estrutural JSON e quais caracteres escapar.

Métodos

Name Description
Dispose()

Faz commit de qualquer texto JSON que ainda não tenha sido limpo e liberta todos os recursos usados pela instância atual.
DisposeAsync()

Confirma assíncronamente qualquer texto JSON remanescente que ainda não tenha sido limpo e liberta todos os recursos usados pela instância atual.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Flush()

Faz commit ao texto JSON escrito até então, tornando-o visível para o destino de saída.
FlushAsync(CancellationToken)

Confirma assíncronamente o texto JSON escrito até então, tornando-o visível para o destino de saída.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Reset()

Reinicia o estado interno desta instância para que possa ser reutilizada.
Reset(IBufferWriter<Byte>, JsonWriterOptions)

Fornece uma API de alto desempenho para escrita apenas direta e sem cache de texto JSON codificado em UTF-8.
Reset(IBufferWriter<Byte>)

Reinicia o estado interno desta instância para que possa ser reutilizada com uma nova instância de IBufferWriter<T>.
Reset(Stream, JsonWriterOptions)

Fornece uma API de alto desempenho para escrita apenas direta e sem cache de texto JSON codificado em UTF-8.
Reset(Stream)

Reinicia o estado interno desta instância para que possa ser reutilizada com uma nova instância de Stream.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
WriteBase64String(JsonEncodedText, ReadOnlySpan<Byte>)

Escreve o nome da propriedade pré-codificada e o valor bruto dos bytes (como uma cadeia JSON codificada em Base64) como parte de um par nome/valor de um objeto JSON.
WriteBase64String(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

Escreve o nome da propriedade e o valor bruto dos bytes (como uma cadeia JSON codificada em Base64) como parte de um par nome/valor de um objeto JSON.
WriteBase64String(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

Escreve o nome da propriedade e o valor bruto dos bytes (como uma cadeia JSON codificada em Base64) como parte de um par nome/valor de um objeto JSON.
WriteBase64String(String, ReadOnlySpan<Byte>)

Escreve o nome da propriedade e o valor bruto dos bytes (como uma cadeia JSON codificada em Base64) como parte de um par nome/valor de um objeto JSON.
WriteBase64StringSegment(ReadOnlySpan<Byte>, Boolean)

Escreve os bytes de entrada como uma string JSON parcial.
WriteBase64StringValue(ReadOnlySpan<Byte>)

Escreve o valor bruto dos bytes como uma string JSON codificada em Base64.
WriteBoolean(JsonEncodedText, Boolean)

Escreve o nome Boolean e valor pré-codificados da propriedade (como um literal JSON, verdadeiro ou falso) como parte de um par nome/valor de um objeto JSON.
WriteBoolean(ReadOnlySpan<Byte>, Boolean)

Escreve um nome de propriedade especificado como um intervalo de bytes de leitura e um Boolean valor (como literal JSON verdadeiro ou falso) como parte de um par nome/valor de um objeto JSON.
WriteBoolean(ReadOnlySpan<Char>, Boolean)

Escreve um nome de propriedade especificado como um intervalo de caracteres apenas de leitura e um Boolean valor (como um literal JSON, verdadeiro ou falso) como parte de um par nome/valor de um objeto JSON.
WriteBoolean(String, Boolean)

Escreve um nome de propriedade especificado como uma cadeia e um Boolean valor (como um literal JSON verdadeiro ou falso) como parte de um par nome/valor de um objeto JSON.
WriteBooleanValue(Boolean)

Escreve um Boolean valor (como um JSON literal , verdadeiro ou falso).
WriteCommentValue(ReadOnlySpan<Byte>)

Escreve um valor de texto UTF-8 como comentário JSON.
WriteCommentValue(ReadOnlySpan<Char>)

Escreve um valor de texto UTF-16 como comentário JSON.
WriteCommentValue(String)

Escreve um valor de texto string como comentário JSON.
WriteEndArray()

Escreve o final de um array JSON.
WriteEndObject()

Escreve o final de um objeto JSON.
WriteNull(JsonEncodedText)

Escreve o nome da propriedade pré-codificada e o literal JSON nulo como parte de um par nome/valor de um objeto JSON.
WriteNull(ReadOnlySpan<Byte>)

Escreve um nome de propriedade especificado como um intervalo de bytes de leitura e o literal JSON nulo como parte de um par nome/valor de um objeto JSON.
WriteNull(ReadOnlySpan<Char>)

Escreve um nome de propriedade especificado como um span de caracteres apenas de leitura e o literal JSON nulo como parte de um par nome/valor de um objeto JSON.
WriteNull(String)

Escreve um nome de propriedade especificado como uma string e o literal JSON nulo como parte de um par nome/valor de um objeto JSON.
WriteNullValue()

Escreve o JSON literalmente null.
WriteNumber(JsonEncodedText, Decimal)

Escreve o nome Decimal e valor pré-codificados da propriedade (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(JsonEncodedText, Double)

Escreve o nome Double e valor pré-codificados da propriedade (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(JsonEncodedText, Int32)

Escreve o nome Int32 e valor pré-codificados da propriedade (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(JsonEncodedText, Int64)

Escreve o nome Int64 e valor pré-codificados da propriedade (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(JsonEncodedText, Single)

Escreve o nome Single e valor pré-codificados da propriedade (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(JsonEncodedText, UInt32)

Escreve o nome UInt32 e valor pré-codificados da propriedade (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(JsonEncodedText, UInt64)

Escreve o nome UInt64 e valor pré-codificados da propriedade (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Decimal)

Escreve um nome de propriedade especificado como um intervalo de bytes apenas de leitura e um Decimal valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Double)

Escreve um nome de propriedade especificado como um intervalo de bytes apenas de leitura e um Double valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Int32)

Escreve um nome de propriedade especificado como um intervalo de bytes apenas de leitura e um Int32 valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Int64)

Escreve um nome de propriedade especificado como um intervalo de bytes apenas de leitura e um Int64 valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, Single)

Escreve um nome de propriedade especificado como um intervalo de bytes apenas de leitura e um Single valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, UInt32)

Escreve um nome de propriedade especificado como um intervalo de bytes apenas de leitura e um UInt32 valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Byte>, UInt64)

Escreve um nome de propriedade especificado como um intervalo de bytes apenas de leitura e um UInt64 valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Decimal)

Escreve um nome de propriedade especificado como um intervalo de caracteres só de leitura e um Decimal valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Double)

Escreve um nome de propriedade especificado como um intervalo de caracteres só de leitura e um Double valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Int32)

Escreve um nome de propriedade especificado como um intervalo de caracteres somente de leitura e um Int32 valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Int64)

Escreve um nome de propriedade especificado como um intervalo de caracteres somente de leitura e um Int64 valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, Single)

Escreve um nome de propriedade especificado como um intervalo de caracteres só de leitura e um Single valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, UInt32)

Escreve um nome de propriedade especificado como um intervalo de caracteres só de leitura e um UInt32 valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(ReadOnlySpan<Char>, UInt64)

Escreve um nome de propriedade especificado como um intervalo de caracteres só de leitura e um UInt64 valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, Decimal)

Escreve um nome de propriedade especificado como uma string e um Decimal valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, Double)

Escreve um nome de propriedade especificado como uma string e um Double valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, Int32)

Escreve um nome de propriedade especificado como uma cadeia e um Int32 valor (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, Int64)

Escreve um nome de propriedade especificado como uma cadeia e um Int64 valor (como um número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, Single)

Escreve um nome de propriedade especificado como uma string e um Single valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, UInt32)

Escreve um nome de propriedade especificado como uma string e um UInt32 valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumber(String, UInt64)

Escreve um nome de propriedade especificado como uma string e um UInt64 valor (como número JSON) como parte de um par nome/valor de um objeto JSON.
WriteNumberValue(Decimal)

Escreve um Decimal valor (como um número JSON).
WriteNumberValue(Double)

Escreve um Double valor (como um número JSON).
WriteNumberValue(Int32)

Escreve um Int32 valor (como um número JSON).
WriteNumberValue(Int64)

Escreve um Int64 valor (como um número JSON).
WriteNumberValue(Single)

Escreve um Single valor (como um número JSON).
WriteNumberValue(UInt32)

Escreve um UInt32 valor (como um número JSON).
WriteNumberValue(UInt64)

Escreve um UInt64 valor (como um número JSON).
WritePropertyName(JsonEncodedText)

Escreve o nome da propriedade pré-codificada (como uma string JSON) como a primeira parte de um par nome/valor de um objeto JSON.
WritePropertyName(ReadOnlySpan<Byte>)

Escreve o nome da propriedade UTF-8 (como uma cadeia JSON) como a primeira parte de um par nome/valor de um objeto JSON.
WritePropertyName(ReadOnlySpan<Char>)

Escreve o nome da propriedade (como uma cadeia JSON) como a primeira parte de um par nome/valor de um objeto JSON.
WritePropertyName(String)

Escreve o nome da propriedade (como uma cadeia JSON) como a primeira parte de um par nome/valor de um objeto JSON.
WriteRawValue(ReadOnlySequence<Byte>, Boolean)

Escreve a entrada como conteúdo JSON. Espera-se que o conteúdo de entrada seja um único valor JSON completo.
WriteRawValue(ReadOnlySpan<Byte>, Boolean)

Escreve a entrada como conteúdo JSON. Espera-se que o conteúdo de entrada seja um único valor JSON completo.
WriteRawValue(ReadOnlySpan<Char>, Boolean)

Escreve a entrada como conteúdo JSON. Espera-se que o conteúdo de entrada seja um único valor JSON completo.
WriteRawValue(String, Boolean)

Escreve a entrada como conteúdo JSON. Espera-se que o conteúdo de entrada seja um único valor JSON completo.
WriteStartArray()

Escreve o início de um array JSON.
WriteStartArray(JsonEncodedText)

Escreve o início de um array JSON com um nome de propriedade pré-codificado como chave.
WriteStartArray(ReadOnlySpan<Byte>)

Escreve o início de um array JSON com um nome de propriedade especificado como um intervalo de bytes apenas de leitura como chave.
WriteStartArray(ReadOnlySpan<Char>)

Escreve o início de um array JSON com um nome de propriedade especificado como um intervalo de caracteres apenas de leitura como chave.
WriteStartArray(String)

Escreve o início de um array JSON com um nome de propriedade especificado como uma string como chave.
WriteStartObject()

Escreve o início de um objeto JSON.
WriteStartObject(JsonEncodedText)

Escreve o início de um objeto JSON com um nome de propriedade pré-codificado como chave.
WriteStartObject(ReadOnlySpan<Byte>)

Escreve o início de um objeto JSON com um nome de propriedade especificado como um espaço de bytes apenas de leitura como chave.
WriteStartObject(ReadOnlySpan<Char>)

Escreve o início de um objeto JSON com um nome de propriedade especificado como um espaço de caracteres de só leitura como chave.
WriteStartObject(String)

Escreve o início de um objeto JSON com um nome de propriedade especificado como uma string como chave.
WriteString(JsonEncodedText, DateTime)

Escreve o nome DateTime e valor pré-codificados da propriedade (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, DateTimeOffset)

Escreve o nome DateTimeOffset e valor pré-codificados da propriedade (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, Guid)

Escreve o nome Guid e valor pré-codificados da propriedade (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, JsonEncodedText)

Escreve o nome da propriedade pré-codificada e o valor pré-codificado (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

Escreve o nome pré-codificado da propriedade e o valor do texto UTF-8 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, ReadOnlySpan<Char>)

Escreve o nome da propriedade pré-codificada e o valor do texto (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, String)

Escreve o nome pré-codificado da propriedade e o valor do texto da cadeia (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, DateTime)

Escreve um nome de propriedade UTF-8 e um DateTime valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

Escreve um nome de propriedade UTF-8 e um DateTimeOffset valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, Guid)

Escreve um nome de propriedade UTF-8 e um Guid valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

Escreve o nome da propriedade UTF-8 e o valor pré-codificado (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

Escreve um nome de propriedade UTF-8 e um valor de texto UTF-8 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)

Escreve um nome de propriedade UTF-8 e um valor de texto UTF-16 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, String)

Escreve um nome de propriedade UTF-8 e um valor de texto de string (como uma string JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, DateTime)

Escreve um nome de propriedade especificado como um espaço de caracteres de apenas leitura e um DateTime valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, DateTimeOffset)

Escreve um nome de propriedade especificado como um espaço de caracteres de apenas leitura e um DateTimeOffset valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, Guid)

Escreve um nome de propriedade especificado como um espaço de caracteres de apenas leitura e um Guid valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, JsonEncodedText)

Escreve o nome da propriedade e o valor pré-codificado (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

Escreve um nome de propriedade UTF-16 e um valor de texto UTF-8 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Escreve um nome de propriedade UTF-16 e um valor de texto UTF-16 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, String)

Escreve um nome de propriedade UTF-16 e um valor de texto em cadeia (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, DateTime)

Escreve um nome de propriedade especificado como uma cadeia e um DateTime valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, DateTimeOffset)

Escreve um nome de propriedade especificado como uma cadeia e um DateTimeOffset valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, Guid)

Escreve um nome de propriedade especificado como uma cadeia e um Guid valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, JsonEncodedText)

Escreve o nome da propriedade e o valor pré-codificado (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, ReadOnlySpan<Byte>)

Escreve um nome de propriedade especificado como uma cadeia e um valor de texto UTF-8 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, ReadOnlySpan<Char>)

Escreve um nome de propriedade especificado como uma cadeia e um valor de texto UTF-16 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, String)

Escreve um nome de propriedade especificado como uma cadeia e um valor de texto de cadeia (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
WriteStringValue(DateTime)

Escreve um DateTime valor (como uma string JSON).
WriteStringValue(DateTimeOffset)

Escreve um DateTimeOffset valor (como uma string JSON).
WriteStringValue(Guid)

Escreve um Guid valor (como uma string JSON).
WriteStringValue(JsonEncodedText)

Escreve o valor do texto pré-codificado (como uma cadeia JSON).
WriteStringValue(ReadOnlySpan<Byte>)

Escreve um valor de texto UTF-8 (como uma string JSON).
WriteStringValue(ReadOnlySpan<Char>)

Escreve um valor de texto UTF-16 (como uma cadeia JSON).
WriteStringValue(String)

Escreve um valor de texto em cadeia (como uma cadeia JSON).
WriteStringValueSegment(ReadOnlySpan<Byte>, Boolean)

Escreve o segmento de valor do texto UTF-8 como uma cadeia JSON parcial.
WriteStringValueSegment(ReadOnlySpan<Char>, Boolean)

Escreve o segmento de valor do texto como uma cadeia JSON parcial.

Métodos da Extensão

Name Description
ConfigureAwait(IAsyncDisposable, Boolean)

Configura como aguarda nas tarefas devolvidas de um descartável assíncrono será realizada.

Aplica-se a