Utf8JsonWriter Classe

Definizione

Fornisce un'API ad alte prestazioni per la scrittura forward-only non memorizzata nella cache del testo JSON con codifica 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
Ereditarietà
Utf8JsonWriter
Implementazioni

Commenti

Utf8JsonWriter scrive il testo in sequenza senza memorizzazione nella cache e per impostazione predefinita rispetta la RFC JSON, ad eccezione della scrittura di commenti.

Un metodo che tenta di scrivere codice JSON non valido quando la convalida è abilitata genera un InvalidOperationException oggetto con un messaggio di errore specifico del contesto.

Per poter formattare l'output con rientro e spazi vuoti, per ignorare la convalida oppure per personalizzare il comportamento di escape, creare un'istanza di JsonWriterOptions e passarla al writer.

Per altre informazioni, vedere Come scrivere serializzatori e deserializzatori personalizzati con System.Text.Json.

Costruttori

Nome Descrizione
Utf8JsonWriter(IBufferWriter<Byte>, JsonWriterOptions)

Inizializza una nuova istanza della Utf8JsonWriter classe utilizzando l'oggetto specificato IBufferWriter<T> per scrivere l'output nelle opzioni di personalizzazione e .

Utf8JsonWriter(Stream, JsonWriterOptions)

Inizializza una nuova istanza della Utf8JsonWriter classe utilizzando il flusso specificato per scrivere l'output nelle opzioni di personalizzazione e .

Proprietà

Nome Descrizione
BytesCommitted

Ottiene il numero totale di byte di cui è stato eseguito il commit nell'output dall'istanza corrente finora.

BytesPending

Ottiene il numero di byte scritti dall'oggetto Utf8JsonWriter finora non ancora scaricati nell'output ed è stato eseguito il commit.

CurrentDepth

Ottiene la profondità del token corrente.

Options

Ottiene il comportamento personalizzato durante la scrittura di JSON usando questa istanza, che indica se formattare l'output durante la scrittura, se ignorare la convalida json strutturale e i caratteri di escape.

Metodi

Nome Descrizione
Dispose()

Esegue il commit di qualsiasi testo JSON lasciato non ancora scaricato e rilascia tutte le risorse usate dall'istanza corrente.

DisposeAsync()

Esegue il commit asincrono di qualsiasi testo JSON lasciato non ancora scaricato e rilascia tutte le risorse usate dall'istanza corrente.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
Flush()

Esegue il commit del testo JSON scritto finora, che lo rende visibile alla destinazione di output.

FlushAsync(CancellationToken)

Esegue il commit asincrono del testo JSON scritto finora, che lo rende visibile alla destinazione di output.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
Reset()

Reimposta lo stato interno di questa istanza in modo che possa essere riutilizzato.

Reset(IBufferWriter<Byte>, JsonWriterOptions)

Fornisce un'API ad alte prestazioni per la scrittura forward-only non memorizzata nella cache del testo JSON con codifica UTF-8.

Reset(IBufferWriter<Byte>)

Reimposta lo stato interno di questa istanza in modo che possa essere riutilizzato con una nuova istanza di IBufferWriter<T>.

Reset(Stream, JsonWriterOptions)

Fornisce un'API ad alte prestazioni per la scrittura forward-only non memorizzata nella cache del testo JSON con codifica UTF-8.

Reset(Stream)

Reimposta lo stato interno di questa istanza in modo che possa essere riutilizzato con una nuova istanza di Stream.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
WriteBase64String(JsonEncodedText, ReadOnlySpan<Byte>)

Scrive il nome della proprietà pre-codificato e il valore dei byte non elaborati (come stringa JSON con codifica Base64) come parte di una coppia nome/valore di un oggetto JSON.

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

Scrive il nome della proprietà e il valore dei byte non elaborati (come stringa JSON con codifica Base64) come parte di una coppia nome/valore di un oggetto JSON.

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

Scrive il nome della proprietà e il valore dei byte non elaborati (come stringa JSON con codifica Base64) come parte di una coppia nome/valore di un oggetto JSON.

WriteBase64String(String, ReadOnlySpan<Byte>)

Scrive il nome della proprietà e il valore dei byte non elaborati (come stringa JSON con codifica Base64) come parte di una coppia nome/valore di un oggetto JSON.

WriteBase64StringSegment(ReadOnlySpan<Byte>, Boolean)

Scrive i byte di input come stringa JSON parziale.

WriteBase64StringValue(ReadOnlySpan<Byte>)

Scrive il valore dei byte non elaborati come stringa JSON con codifica Base64.

WriteBoolean(JsonEncodedText, Boolean)

Scrive il nome e Boolean il valore della proprietà pre-codificati (come valore letterale JSON true o false) come parte di una coppia nome/valore di un oggetto JSON.

WriteBoolean(ReadOnlySpan<Byte>, Boolean)

Scrive un nome di proprietà specificato come intervallo di byte di sola lettura e un Boolean valore (come valore letterale JSON true o false) come parte di una coppia nome/valore di un oggetto JSON.

WriteBoolean(ReadOnlySpan<Char>, Boolean)

Scrive un nome di proprietà specificato come intervallo di caratteri di sola lettura e un Boolean valore (come valore letterale JSON true o false) come parte di una coppia nome/valore di un oggetto JSON.

WriteBoolean(String, Boolean)

Scrive un nome di proprietà specificato come stringa e un Boolean valore (come valore letterale JSON true o false) come parte di una coppia nome/valore di un oggetto JSON.

WriteBooleanValue(Boolean)

Scrive un Boolean valore (come valore letterale JSON true o false).

WriteCommentValue(ReadOnlySpan<Byte>)

Scrive un valore di testo UTF-8 come commento JSON.

WriteCommentValue(ReadOnlySpan<Char>)

Scrive un valore di testo UTF-16 come commento JSON.

WriteCommentValue(String)

Scrive un valore di testo stringa come commento JSON.

WriteEndArray()

Scrive la fine di una matrice JSON.

WriteEndObject()

Scrive la fine di un oggetto JSON.

WriteNull(JsonEncodedText)

Scrive il nome della proprietà pre-codificata e il valore letterale JSON Null come parte di una coppia nome/valore di un oggetto JSON.

WriteNull(ReadOnlySpan<Byte>)

Scrive un nome di proprietà specificato come intervallo di byte di sola lettura e il valore letterale JSON Null come parte di una coppia nome/valore di un oggetto JSON.

WriteNull(ReadOnlySpan<Char>)

Scrive un nome di proprietà specificato come intervallo di caratteri di sola lettura e il valore letterale JSON Null come parte di una coppia nome/valore di un oggetto JSON.

WriteNull(String)

Scrive un nome di proprietà specificato come stringa e il valore letterale JSON Null come parte di una coppia nome/valore di un oggetto JSON.

WriteNullValue()

Scrive il valore letterale JSON null.

WriteNumber(JsonEncodedText, Decimal)

Scrive il nome e Decimal il valore della proprietà pre-codificati (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(JsonEncodedText, Double)

Scrive il nome e Double il valore della proprietà pre-codificati (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(JsonEncodedText, Int32)

Scrive il nome e Int32 il valore della proprietà pre-codificati (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(JsonEncodedText, Int64)

Scrive il nome e Int64 il valore della proprietà pre-codificati (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(JsonEncodedText, Single)

Scrive il nome e Single il valore della proprietà pre-codificati (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(JsonEncodedText, UInt32)

Scrive il nome e UInt32 il valore della proprietà pre-codificati (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(JsonEncodedText, UInt64)

Scrive il nome e UInt64 il valore della proprietà pre-codificati (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Byte>, Decimal)

Scrive un nome di proprietà specificato come intervallo di byte di sola lettura e un Decimal valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Byte>, Double)

Scrive un nome di proprietà specificato come intervallo di byte di sola lettura e un Double valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Byte>, Int32)

Scrive un nome di proprietà specificato come intervallo di byte di sola lettura e un Int32 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Byte>, Int64)

Scrive un nome di proprietà specificato come intervallo di byte di sola lettura e un Int64 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Byte>, Single)

Scrive un nome di proprietà specificato come intervallo di byte di sola lettura e un Single valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Byte>, UInt32)

Scrive un nome di proprietà specificato come intervallo di byte di sola lettura e un UInt32 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Byte>, UInt64)

Scrive un nome di proprietà specificato come intervallo di byte di sola lettura e un UInt64 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Char>, Decimal)

Scrive un nome di proprietà specificato come intervallo di caratteri di sola lettura e un Decimal valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Char>, Double)

Scrive un nome di proprietà specificato come intervallo di caratteri di sola lettura e un Double valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Char>, Int32)

Scrive un nome di proprietà specificato come intervallo di caratteri di sola lettura e un Int32 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Char>, Int64)

Scrive un nome di proprietà specificato come intervallo di caratteri di sola lettura e un Int64 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Char>, Single)

Scrive un nome di proprietà specificato come intervallo di caratteri di sola lettura e un Single valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Char>, UInt32)

Scrive un nome di proprietà specificato come intervallo di caratteri di sola lettura e un UInt32 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(ReadOnlySpan<Char>, UInt64)

Scrive un nome di proprietà specificato come intervallo di caratteri di sola lettura e un UInt64 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(String, Decimal)

Scrive un nome di proprietà specificato come stringa e un Decimal valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(String, Double)

Scrive un nome di proprietà specificato come stringa e un Double valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(String, Int32)

Scrive un nome di proprietà specificato come stringa e un Int32 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(String, Int64)

Scrive un nome di proprietà specificato come stringa e un Int64 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(String, Single)

Scrive un nome di proprietà specificato come stringa e un Single valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(String, UInt32)

Scrive un nome di proprietà specificato come stringa e un UInt32 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumber(String, UInt64)

Scrive un nome di proprietà specificato come stringa e un UInt64 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteNumberValue(Decimal)

Scrive un Decimal valore (come numero JSON).

WriteNumberValue(Double)

Scrive un Double valore (come numero JSON).

WriteNumberValue(Int32)

Scrive un Int32 valore (come numero JSON).

WriteNumberValue(Int64)

Scrive un Int64 valore (come numero JSON).

WriteNumberValue(Single)

Scrive un Single valore (come numero JSON).

WriteNumberValue(UInt32)

Scrive un UInt32 valore (come numero JSON).

WriteNumberValue(UInt64)

Scrive un UInt64 valore (come numero JSON).

WritePropertyName(JsonEncodedText)

Scrive il nome della proprietà pre-codificato (come stringa JSON) come prima parte di una coppia nome/valore di un oggetto JSON.

WritePropertyName(ReadOnlySpan<Byte>)

Scrive il nome della proprietà UTF-8 (come stringa JSON) come prima parte di una coppia nome/valore di un oggetto JSON.

WritePropertyName(ReadOnlySpan<Char>)

Scrive il nome della proprietà (come stringa JSON) come prima parte di una coppia nome/valore di un oggetto JSON.

WritePropertyName(String)

Scrive il nome della proprietà (come stringa JSON) come prima parte di una coppia nome/valore di un oggetto JSON.

WriteRawValue(ReadOnlySequence<Byte>, Boolean)

Scrive l'input come contenuto JSON. È previsto che il contenuto di input sia un singolo valore JSON completo.

WriteRawValue(ReadOnlySpan<Byte>, Boolean)

Scrive l'input come contenuto JSON. È previsto che il contenuto di input sia un singolo valore JSON completo.

WriteRawValue(ReadOnlySpan<Char>, Boolean)

Scrive l'input come contenuto JSON. È previsto che il contenuto di input sia un singolo valore JSON completo.

WriteRawValue(String, Boolean)

Scrive l'input come contenuto JSON. È previsto che il contenuto di input sia un singolo valore JSON completo.

WriteStartArray()

Scrive l'inizio di una matrice JSON.

WriteStartArray(JsonEncodedText)

Scrive l'inizio di una matrice JSON con un nome di proprietà pre-codificato come chiave.

WriteStartArray(ReadOnlySpan<Byte>)

Scrive l'inizio di una matrice JSON con un nome di proprietà specificato come intervallo di byte di sola lettura come chiave.

WriteStartArray(ReadOnlySpan<Char>)

Scrive l'inizio di una matrice JSON con un nome di proprietà specificato come intervallo di caratteri di sola lettura come chiave.

WriteStartArray(String)

Scrive l'inizio di una matrice JSON con un nome di proprietà specificato come stringa come chiave.

WriteStartObject()

Scrive l'inizio di un oggetto JSON.

WriteStartObject(JsonEncodedText)

Scrive l'inizio di un oggetto JSON con un nome di proprietà pre-codificato come chiave.

WriteStartObject(ReadOnlySpan<Byte>)

Scrive l'inizio di un oggetto JSON con un nome di proprietà specificato come intervallo di byte di sola lettura come chiave.

WriteStartObject(ReadOnlySpan<Char>)

Scrive l'inizio di un oggetto JSON con un nome di proprietà specificato come intervallo di caratteri di sola lettura come chiave.

WriteStartObject(String)

Scrive l'inizio di un oggetto JSON con un nome di proprietà specificato come stringa come chiave.

WriteString(JsonEncodedText, DateTime)

Scrive il nome e DateTime il valore della proprietà pre-codificati (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(JsonEncodedText, DateTimeOffset)

Scrive il nome e DateTimeOffset il valore della proprietà pre-codificati (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(JsonEncodedText, Guid)

Scrive il nome e Guid il valore della proprietà pre-codificati (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(JsonEncodedText, JsonEncodedText)

Scrive il nome della proprietà pre-codificata e il valore pre-codificato (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

Scrive il nome della proprietà pre-codificata e il valore di testo UTF-8 (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

Scrive il nome della proprietà pre-codificata e il valore di testo (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(JsonEncodedText, String)

Scrive il nome della proprietà pre-codificata e il valore di testo stringa (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(ReadOnlySpan<Byte>, DateTime)

Scrive un nome di proprietà UTF-8 e un DateTime valore (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

Scrive un nome di proprietà UTF-8 e un DateTimeOffset valore (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(ReadOnlySpan<Byte>, Guid)

Scrive un nome di proprietà UTF-8 e un Guid valore (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

Scrive il nome della proprietà UTF-8 e il valore pre-codificato (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

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

Scrive un nome di proprietà UTF-8 e un valore di testo UTF-8 (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

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

Scrive un nome di proprietà UTF-8 e un valore di testo UTF-16 (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(ReadOnlySpan<Byte>, String)

Scrive un nome di proprietà UTF-8 e un valore di testo stringa (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(ReadOnlySpan<Char>, DateTime)

Scrive un nome di proprietà specificato come intervallo di caratteri di sola lettura e un DateTime valore (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

Scrive un nome di proprietà specificato come intervallo di caratteri di sola lettura e un DateTimeOffset valore (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(ReadOnlySpan<Char>, Guid)

Scrive un nome di proprietà specificato come intervallo di caratteri di sola lettura e un Guid valore (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(ReadOnlySpan<Char>, JsonEncodedText)

Scrive il nome della proprietà e il valore pre-codificato (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

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

Scrive un nome di proprietà UTF-16 e un valore di testo UTF-8 (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

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

Scrive un nome di proprietà UTF-16 e un valore di testo UTF-16 (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(ReadOnlySpan<Char>, String)

Scrive un nome di proprietà UTF-16 e un valore di testo stringa (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(String, DateTime)

Scrive un nome di proprietà specificato come stringa e un DateTime valore (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(String, DateTimeOffset)

Scrive un nome di proprietà specificato come stringa e un DateTimeOffset valore (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(String, Guid)

Scrive un nome di proprietà specificato come stringa e un Guid valore (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(String, JsonEncodedText)

Scrive il nome della proprietà e il valore pre-codificato (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(String, ReadOnlySpan<Byte>)

Scrive un nome di proprietà specificato come stringa e un valore di testo UTF-8 (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(String, ReadOnlySpan<Char>)

Scrive un nome di proprietà specificato come stringa e un valore di testo UTF-16 (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteString(String, String)

Scrive un nome di proprietà specificato come stringa e un valore di testo stringa (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.

WriteStringValue(DateTime)

Scrive un DateTime valore (come stringa JSON).

WriteStringValue(DateTimeOffset)

Scrive un DateTimeOffset valore (come stringa JSON).

WriteStringValue(Guid)

Scrive un Guid valore (come stringa JSON).

WriteStringValue(JsonEncodedText)

Scrive il valore di testo pre-codificato (come stringa JSON).

WriteStringValue(ReadOnlySpan<Byte>)

Scrive un valore di testo UTF-8 (come stringa JSON).

WriteStringValue(ReadOnlySpan<Char>)

Scrive un valore di testo UTF-16 (come stringa JSON).

WriteStringValue(String)

Scrive un valore di testo stringa (come stringa JSON).

WriteStringValueSegment(ReadOnlySpan<Byte>, Boolean)

Scrive il segmento di valore di testo UTF-8 come stringa JSON parziale.

WriteStringValueSegment(ReadOnlySpan<Char>, Boolean)

Scrive il segmento di valore di testo come stringa JSON parziale.

Metodi di estensione

Nome Descrizione
ConfigureAwait(IAsyncDisposable, Boolean)

Configura il modo in cui verranno eseguite le attese nelle attività restituite da un oggetto eliminabile asincrono.

Si applica a