Utf8JsonWriter Classe

Riferimento

Definizione

Spazio dei nomi:: System.Text.Json

Assembly:: System.Text.Json.dll

Pacchetto:: System.Text.Json v8.0.5

Pacchetto:: System.Text.Json v9.0.0-rc.2.24473.5

Origine:: Utf8JsonWriter.cs

Origine:: Utf8JsonWriter.cs

Origine:: Utf8JsonWriter.cs

Origine:: Utf8JsonWriter.cs

Origine:: Utf8JsonWriter.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à: Object
Utf8JsonWriter

Implementazioni: IAsyncDisposable IDisposable

Commenti

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

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

Per poter formattare l'output con rientro e spazi vuoti, ignorare la convalida oppure 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

Utf8JsonWriter(IBufferWriter<Byte>, JsonWriterOptions)	Inizializza una nuova istanza della classe Utf8JsonWriter utilizzando il IBufferWriter<T> specificato per scrivere l'output nelle opzioni di personalizzazione e .
Utf8JsonWriter(Stream, JsonWriterOptions)	Inizializza una nuova istanza della classe Utf8JsonWriter utilizzando il flusso specificato per scrivere l'output nelle opzioni di personalizzazione e .

Proprietà

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 dal 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

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>)	Reimposta lo stato interno di questa istanza in modo che possa essere riutilizzato con una nuova istanza di IBufferWriter<T>.
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.
WriteBase64StringValue(ReadOnlySpan<Byte>)	Scrive il valore dei byte non elaborati come stringa JSON con codifica Base64 come elemento di una matrice JSON.
WriteBoolean(JsonEncodedText, Boolean)	Scrive il nome della proprietà pre-codificata e il valore Boolean (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 valore Boolean (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 valore Boolean (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 valore Boolean (come valore letterale JSON true o false) come parte di una coppia nome/valore di un oggetto JSON.
WriteBooleanValue(Boolean)	Scrive un valore Boolean (come valore letterale JSON true o false) come elemento di una matrice JSON.
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 come elemento di una matrice JSON.
WriteNumber(JsonEncodedText, Decimal)	Scrive il nome della proprietà pre-codificata e Decimal valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.
WriteNumber(JsonEncodedText, Double)	Scrive il nome della proprietà pre-codificata e Double valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.
WriteNumber(JsonEncodedText, Int32)	Scrive il nome della proprietà pre-codificata e Int32 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.
WriteNumber(JsonEncodedText, Int64)	Scrive il nome della proprietà pre-codificata e Int64 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.
WriteNumber(JsonEncodedText, Single)	Scrive il nome della proprietà pre-codificata e Single valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.
WriteNumber(JsonEncodedText, UInt32)	Scrive il nome della proprietà pre-codificata e UInt32 valore (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.
WriteNumber(JsonEncodedText, UInt64)	Scrive il nome della proprietà pre-codificata e UInt64 valore (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 valore Decimal (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 valore Double (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 sola lettura di byte e un valore Int32 (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 sola lettura di byte e un valore Int64 (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 valore Single (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 valore UInt32 (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 valore UInt64 (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 valore Decimal (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 valore Double (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 valore Int32 (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 valore Int64 (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 valore Single (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 valore UInt32 (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 valore UInt64 (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 valore Decimal (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 valore Double (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 valore Int32 (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 valore Int64 (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 valore Single (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 valore UInt32 (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 valore UInt64 (come numero JSON) come parte di una coppia nome/valore di un oggetto JSON.
WriteNumberValue(Decimal)	Scrive un valore Decimal (come numero JSON) come elemento di una matrice JSON.
WriteNumberValue(Double)	Scrive un valore Double (come numero JSON) come elemento di una matrice JSON.
WriteNumberValue(Int32)	Scrive un valore Int32 (come numero JSON) come elemento di una matrice JSON.
WriteNumberValue(Int64)	Scrive un valore Int64 (come numero JSON) come elemento di una matrice JSON.
WriteNumberValue(Single)	Scrive un valore Single (come numero JSON) come elemento di una matrice JSON.
WriteNumberValue(UInt32)	Scrive un valore UInt32 (come numero JSON) come elemento di una matrice JSON.
WriteNumberValue(UInt64)	Scrive un valore UInt64 (come numero JSON) come elemento di una matrice 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 della proprietà pre-codificata e DateTime valore (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.
WriteString(JsonEncodedText, DateTimeOffset)	Scrive il nome della proprietà pre-codificata e DateTimeOffset valore (come stringa JSON) come parte di una coppia nome/valore di un oggetto JSON.
WriteString(JsonEncodedText, Guid)	Scrive il nome della proprietà pre-codificata e Guid valore (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 valore DateTime (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 valore DateTimeOffset (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 valore Guid (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 valore DateTime (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 valore DateTimeOffset (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 valore Guid (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 valore DateTime (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 valore DateTimeOffset (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 valore Guid (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 valore DateTime (come stringa JSON) come elemento di una matrice JSON.
WriteStringValue(DateTimeOffset)	Scrive un valore DateTimeOffset (come stringa JSON) come elemento di una matrice JSON.
WriteStringValue(Guid)	Scrive un valore Guid (come stringa JSON) come elemento di una matrice JSON.
WriteStringValue(JsonEncodedText)	Scrive il valore di testo pre-codificato (come stringa JSON) come elemento di una matrice JSON.
WriteStringValue(ReadOnlySpan<Byte>)	Scrive un valore di testo UTF-8 (come stringa JSON) come elemento di una matrice JSON.
WriteStringValue(ReadOnlySpan<Char>)	Scrive un valore di testo UTF-16 (come stringa JSON) come elemento di una matrice JSON.
WriteStringValue(String)	Scrive un valore di testo stringa (come stringa JSON) come elemento di una matrice JSON.

Metodi di estensione

ConfigureAwait(IAsyncDisposable, Boolean)

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

Si applica a

Condividi tramite