Utf8JsonWriter Classe

  • Referência

Definição

Namespace:
System.Text.Json
Assembly:
System.Text.Json.dll
Pacote:
System.Text.Json v8.0.5
Pacote:
System.Text.Json v9.0.0-rc.2.24473.5
Origem:
Utf8JsonWriter.cs
Origem:
Utf8JsonWriter.cs
Origem:
Utf8JsonWriter.cs
Origem:
Utf8JsonWriter.cs
Origem:
Utf8JsonWriter.cs

Fornece uma API de alto desempenho para gravação sem cache somente para encaminhamento 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

Comentários

Utf8JsonWriter grava o texto sequencialmente sem cache e, por padrão, adere ao JSON RFC, 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, ignorar a validação ou personalizar o comportamento de escape, criar uma instância de JsonWriterOptions e passá-la para o gravador.

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

Construtores

Utf8JsonWriter(IBufferWriter<Byte>, JsonWriterOptions)

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

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

Propriedades

BytesCommitted

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

Obtém o número de bytes gravados pelo Utf8JsonWriter até agora 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 escrever JSON usando essa instância, o que indica se a saída deve ser formatada durante a gravação, se deseja ignorar a validação JSON estrutural e quais caracteres devem ser escapados.

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 forma 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 escrito até agora, o que o torna visível para o destino de saída.
FlushAsync(CancellationToken)

Confirma de forma assíncrona o texto JSON escrito até agora, 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 Objectatual.

(Herdado de Object)
Reset()

Redefine o estado interno dessa instância para que ela possa ser reutilizado.
Reset(IBufferWriter<Byte>)

Redefine o estado interno dessa instância para que ela possa ser reutilizado com uma nova instância de IBufferWriter<T>.
Reset(Stream)

Redefine o estado interno dessa instância para que ela possa ser reutilizado 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 verdadeiro 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 somente leitura de bytes e um valor de Boolean (como um literal JSON verdadeiro ou falso) 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 e um valor de Boolean (como um literal JSON verdadeiro 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 Boolean (como um literal JSON verdadeiro ou false) como parte de um par nome/valor de um objeto JSON.
WriteBooleanValue(Boolean)

Grava um valor Boolean (como um literal JSON verdadeiro 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 final de uma matriz JSON.
WriteEndObject()

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

Grava 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>)

Grava um nome de propriedade especificado como um intervalo somente leitura de bytes e o literal JSON nulo 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 nulo 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 nulo como parte de um par nome/valor de um objeto JSON.
WriteNullValue()

Grava o literal JSON nulo como um elemento de uma matriz JSON.
WriteNumber(JsonEncodedText, Decimal)

Grava o nome da propriedade pré-codificada e o valor 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 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 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 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 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 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 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 somente leitura de bytes e um valor 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 somente leitura de bytes e um valor 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 somente leitura de bytes e um valor 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 somente leitura de bytes e um valor 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 somente leitura de bytes e um valor 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 somente leitura de bytes e um valor 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 somente leitura de bytes e um valor 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 e 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 e 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 e 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 e 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 e 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 e 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 e 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 Decimal (como um número JSON) como um elemento de uma matriz JSON.
WriteNumberValue(Double)

Grava um valor Double (como um número JSON) como um elemento de uma matriz JSON.
WriteNumberValue(Int32)

Grava um valor Int32 (como um número JSON) como um elemento de uma matriz JSON.
WriteNumberValue(Int64)

Grava um valor Int64 (como um número JSON) como um elemento de uma matriz JSON.
WriteNumberValue(Single)

Grava um valor Single (como um número JSON) como um elemento de uma matriz JSON.
WriteNumberValue(UInt32)

Grava um valor UInt32 (como um número JSON) como um elemento de uma matriz JSON.
WriteNumberValue(UInt64)

Grava um valor 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é-codificado como a chave.
WriteStartArray(ReadOnlySpan<Byte>)

Grava o início de uma matriz JSON com um nome de propriedade especificado como um intervalo somente leitura de bytes 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é-codificado como a chave.
WriteStartObject(ReadOnlySpan<Byte>)

Grava o início de um objeto JSON com um nome de propriedade especificado como um intervalo somente leitura de bytes 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 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 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 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é-codificado 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 da 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 um nome de 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 um nome de 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 um nome de 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 um nome de propriedade UTF-8 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(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)

Grava um nome de propriedade UTF-8 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(ReadOnlySpan<Byte>, String)

Grava um nome de propriedade UTF-8 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.
WriteString(ReadOnlySpan<Char>, DateTime)

Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura e 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 e 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 e 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 um nome de propriedade UTF-16 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(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Grava um nome de propriedade UTF-16 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(ReadOnlySpan<Char>, String)

Grava um nome de propriedade UTF-16 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.
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 DateTime (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.
WriteStringValue(DateTimeOffset)

Grava um valor DateTimeOffset (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.
WriteStringValue(Guid)

Grava um valor 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 serão executadas.

Aplica-se a