Condividi tramite


JsonSerializer.SerializeAsync Metodo

Definizione

Overload

SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel Stream.

SerializeAsync(PipeWriter, Object, Type, JsonSerializerContext, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel PipeWriter.

SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)

Converte in modo asincrono il valore di un tipo specificato in testo JSON con codifica UTF-8 e lo scrive nel flusso specificato.

SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel Stream.

SerializeAsync(PipeWriter, Object, JsonTypeInfo, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel PipeWriter.

SerializeAsync(PipeWriter, Object, Type, JsonSerializerOptions, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel PipeWriter.

SerializeAsync<TValue>(PipeWriter, TValue, JsonSerializerOptions, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel PipeWriter.

SerializeAsync<TValue>(PipeWriter, TValue, JsonTypeInfo<TValue>, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel PipeWriter.

SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)

Converte in modo asincrono un valore di un tipo specificato da un parametro di tipo generico in testo JSON con codifica UTF-8 e lo scrive in un flusso.

SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel Stream.

SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)

Origine:
JsonSerializer.Write.Stream.cs
Origine:
JsonSerializer.Write.Stream.cs
Origine:
JsonSerializer.Write.Stream.cs

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel Stream.

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);
static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

utf8Json
Stream

Il Stream UTF-8 in cui scrivere.

value
Object

Valore da convertire.

inputType
Type

Tipo del value da convertire.

context
JsonSerializerContext

Provider di metadati per i tipi serializzabili.

cancellationToken
CancellationToken

Il CancellationToken che può essere utilizzato per annullare l'operazione di scrittura.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

inputType non è compatibile con value.

utf8Json, inputTypeo context è null.

Non esiste alcuna JsonConverter compatibile per inputType o i relativi membri serializzabili.

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Serialize(Stream, Object, Type, JsonSerializerContext).

Si applica a

SerializeAsync(PipeWriter, Object, Type, JsonSerializerContext, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel PipeWriter.

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Pipelines.PipeWriter utf8Json, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);
static member SerializeAsync : System.IO.Pipelines.PipeWriter * obj * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SerializeAsync (utf8Json As PipeWriter, value As Object, inputType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

utf8Json
PipeWriter

Il PipeWriter UTF-8 in cui scrivere.

value
Object

Valore da convertire.

inputType
Type

Tipo del value da convertire.

context
JsonSerializerContext

Provider di metadati per i tipi serializzabili.

cancellationToken
CancellationToken

Il CancellationToken che può essere utilizzato per annullare l'operazione di scrittura.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

inputType non è compatibile con value.

utf8Json, inputTypeo context è null.

Non esiste alcuna JsonConverter compatibile

per inputType o i relativi membri serializzabili.

Si applica a

SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)

Origine:
JsonSerializer.Write.Stream.cs
Origine:
JsonSerializer.Write.Stream.cs
Origine:
JsonSerializer.Write.Stream.cs

Converte in modo asincrono il valore di un tipo specificato in testo JSON con codifica UTF-8 e lo scrive nel flusso specificato.

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object value, Type inputType, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);
static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

utf8Json
Stream

Flusso UTF-8 in cui scrivere.

value
Object

Valore da convertire.

inputType
Type

Tipo del value da convertire.

options
JsonSerializerOptions

Opzioni per controllare il comportamento di serializzazione.

cancellationToken
CancellationToken

Token che può essere usato per annullare l'operazione di scrittura.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

inputType non è compatibile con value.

utf8Json o inputType è null.

Non esiste alcuna JsonConverter compatibile per inputType o i relativi membri serializzabili.

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Serialize(Stream, Object, Type, JsonSerializerOptions).

Si applica a

SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)

Origine:
JsonSerializer.Write.Stream.cs
Origine:
JsonSerializer.Write.Stream.cs

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel Stream.

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);
static member SerializeAsync : System.IO.Stream * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SerializeAsync (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

utf8Json
Stream

Il Stream UTF-8 in cui scrivere.

value
Object

Valore da convertire.

jsonTypeInfo
JsonTypeInfo

Metadati sul tipo da convertire.

cancellationToken
CancellationToken

Il CancellationToken che può essere utilizzato per annullare l'operazione di scrittura.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

utf8Json è null.

value non corrisponde al tipo di jsonTypeInfo.

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Si applica a

SerializeAsync(PipeWriter, Object, JsonTypeInfo, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel PipeWriter.

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Pipelines.PipeWriter utf8Json, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);
static member SerializeAsync : System.IO.Pipelines.PipeWriter * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SerializeAsync (utf8Json As PipeWriter, value As Object, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

utf8Json
PipeWriter

Il PipeWriter UTF-8 in cui scrivere.

value
Object

Valore da convertire.

jsonTypeInfo
JsonTypeInfo

Metadati sul tipo da convertire.

cancellationToken
CancellationToken

Il CancellationToken che può essere utilizzato per annullare l'operazione di scrittura.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

utf8Json è null.

value non corrisponde al tipo di jsonTypeInfo.

Si applica a

SerializeAsync(PipeWriter, Object, Type, JsonSerializerOptions, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel PipeWriter.

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Pipelines.PipeWriter utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
static member SerializeAsync : System.IO.Pipelines.PipeWriter * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SerializeAsync (utf8Json As PipeWriter, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

utf8Json
PipeWriter

Il PipeWriter UTF-8 in cui scrivere.

value
Object

Valore da convertire.

inputType
Type

Tipo del value da convertire.

options
JsonSerializerOptions

Opzioni per controllare il comportamento di conversione.

cancellationToken
CancellationToken

Il CancellationToken che può essere utilizzato per annullare l'operazione di scrittura.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

inputType non è compatibile con value.

utf8Json o inputType è null.

Non esiste alcuna JsonConverter compatibile

per inputType o i relativi membri serializzabili.

Si applica a

SerializeAsync<TValue>(PipeWriter, TValue, JsonSerializerOptions, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel PipeWriter.

public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Pipelines.PipeWriter utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
static member SerializeAsync : System.IO.Pipelines.PipeWriter * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SerializeAsync(Of TValue) (utf8Json As PipeWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri di tipo

TValue

Tipo del valore da serializzare.

Parametri

utf8Json
PipeWriter

Il PipeWriter UTF-8 in cui scrivere.

value
TValue

Valore da convertire.

options
JsonSerializerOptions

Opzioni per controllare il comportamento di conversione.

cancellationToken
CancellationToken

Il CancellationToken che può essere utilizzato per annullare l'operazione di scrittura.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

utf8Json è null.

Non esiste alcuna JsonConverter compatibile

per TValue o i relativi membri serializzabili.

Si applica a

SerializeAsync<TValue>(PipeWriter, TValue, JsonTypeInfo<TValue>, CancellationToken)

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel PipeWriter.

public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Pipelines.PipeWriter utf8Json, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);
static member SerializeAsync : System.IO.Pipelines.PipeWriter * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SerializeAsync(Of TValue) (utf8Json As PipeWriter, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri di tipo

TValue

Tipo del valore da serializzare.

Parametri

utf8Json
PipeWriter

Il PipeWriter UTF-8 in cui scrivere.

value
TValue

Valore da convertire.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadati sul tipo da convertire.

cancellationToken
CancellationToken

Il CancellationToken che può essere utilizzato per annullare l'operazione di scrittura.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

utf8Json è null.

Si applica a

SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)

Origine:
JsonSerializer.Write.Stream.cs
Origine:
JsonSerializer.Write.Stream.cs
Origine:
JsonSerializer.Write.Stream.cs

Converte in modo asincrono un valore di un tipo specificato da un parametro di tipo generico in testo JSON con codifica UTF-8 e lo scrive in un flusso.

public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);
static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri di tipo

TValue

Tipo del valore da serializzare.

Parametri

utf8Json
Stream

Flusso UTF-8 in cui scrivere.

value
TValue

Valore da convertire.

options
JsonSerializerOptions

Opzioni per controllare il comportamento di serializzazione.

cancellationToken
CancellationToken

Token che può essere usato per annullare l'operazione di scrittura.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

utf8Json è null.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi membri serializzabili.

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Si applica a

SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)

Origine:
JsonSerializer.Write.Stream.cs
Origine:
JsonSerializer.Write.Stream.cs
Origine:
JsonSerializer.Write.Stream.cs

Converte il valore fornito in testo JSON con codifica UTF-8 e lo scrive nel Stream.

public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);
static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri di tipo

TValue

Tipo del valore da serializzare.

Parametri

utf8Json
Stream

Il Stream UTF-8 in cui scrivere.

value
TValue

Valore da convertire.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadati sul tipo da convertire.

cancellationToken
CancellationToken

Il CancellationToken che può essere utilizzato per annullare l'operazione di scrittura.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

utf8Json è null.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi membri serializzabili.

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Si applica a