JsonSerializer.SerializeAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken) |
Converte assíncronamente o valor de um tipo especificado para texto JSON codificado em UTF-8 e escreve-o no fluxo especificado. |
| SerializeAsync(PipeWriter, Object, Type, JsonSerializerContext, CancellationToken) |
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no PipeWriterarquivo . |
| SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken) |
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no Streamarquivo . |
| SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken) |
Converte o valor fornecido em texto JSON codificado em UTF-8 e escreve-o no Streamarquivo . |
| SerializeAsync(PipeWriter, Object, JsonTypeInfo, CancellationToken) |
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no PipeWriterarquivo . |
| SerializeAsync(PipeWriter, Object, Type, JsonSerializerOptions, CancellationToken) |
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no PipeWriterarquivo . |
| SerializeAsync<TValue>(PipeWriter, TValue, JsonSerializerOptions, CancellationToken) |
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no PipeWriterarquivo . |
| SerializeAsync<TValue>(PipeWriter, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no PipeWriterarquivo . |
| SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken) |
Converte assíncronamente um valor de um tipo especificado por um parâmetro genérico de tipo para texto JSON codificado em UTF-8 e escreve-o num fluxo. |
| SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no Streamarquivo . |
SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)
Converte assíncronamente o valor de um tipo especificado para texto JSON codificado em UTF-8 e escreve-o no fluxo especificado.
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Taskstatic member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Shared Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- utf8Json
- Stream
O fluxo UTF-8 para escrever.
- value
- Object
O valor a converter.
- inputType
- Type
O tipo do value para converter.
- options
- JsonSerializerOptions
Opções para controlar o comportamento de serialização.
- cancellationToken
- CancellationToken
Um token que pode ser usado para cancelar a operação de escrita.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
- Atributos
Exceções
inputType não é compatível com value.
utf8Json ou inputType é null.
Não há membros compatíveis JsonConverter para inputType nem serializáveis.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações, veja Como serializar e desserializar JSON.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Serialize(Stream, Object, Type, JsonSerializerOptions).
Aplica-se a
SerializeAsync(PipeWriter, Object, Type, JsonSerializerContext, CancellationToken)
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no PipeWriterarquivo .
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.TaskPublic Function SerializeAsync (utf8Json As PipeWriter, value As Object, inputType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- utf8Json
- PipeWriter
O UTF-8 PipeWriter para escrever.
- value
- Object
O valor a converter.
- inputType
- Type
O tipo do value para converter.
- context
- JsonSerializerContext
Um fornecedor de metadados para tipos serializáveis.
- cancellationToken
- CancellationToken
Isso CancellationToken pode ser usado para cancelar a operação de escrita.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
Exceções
inputType não é compatível com value.
utf8Json, inputType, ou context é null.
Não há membros compatíveis JsonConverter para inputType nem serializáveis.
Aplica-se a
SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no Streamarquivo .
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.TaskPublic Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- value
- Object
O valor a converter.
- inputType
- Type
O tipo do value para converter.
- context
- JsonSerializerContext
Um fornecedor de metadados para tipos serializáveis.
- cancellationToken
- CancellationToken
Isso CancellationToken pode ser usado para cancelar a operação de escrita.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
Exceções
inputType não é compatível com value.
utf8Json, inputType, ou context é null.
Não há membros compatíveis JsonConverter para inputType nem serializáveis.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Serialize(Stream, Object, Type, JsonSerializerContext).
Aplica-se a
SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)
Converte o valor fornecido em texto JSON codificado em UTF-8 e escreve-o no Streamarquivo .
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.TaskPublic Function SerializeAsync (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- value
- Object
O valor a converter.
- jsonTypeInfo
- JsonTypeInfo
Metadados sobre o tipo a converter.
- cancellationToken
- CancellationToken
Isso CancellationToken pode ser usado para cancelar a operação de escrita.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
Exceções
utf8Json é null.
value não corresponde ao tipo de jsonTypeInfo.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Aplica-se a
SerializeAsync(PipeWriter, Object, JsonTypeInfo, CancellationToken)
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no PipeWriterarquivo .
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.TaskPublic Function SerializeAsync (utf8Json As PipeWriter, value As Object, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- utf8Json
- PipeWriter
O UTF-8 PipeWriter para escrever.
- value
- Object
O valor a converter.
- jsonTypeInfo
- JsonTypeInfo
Metadados sobre o tipo a converter.
- cancellationToken
- CancellationToken
Isso CancellationToken pode ser usado para cancelar a operação de escrita.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
Exceções
utf8Json é null.
value não corresponde ao tipo de jsonTypeInfo.
Aplica-se a
SerializeAsync(PipeWriter, Object, Type, JsonSerializerOptions, CancellationToken)
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no PipeWriterarquivo .
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);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);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member SerializeAsync : System.IO.Pipelines.PipeWriter * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Taskstatic member SerializeAsync : System.IO.Pipelines.PipeWriter * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function SerializeAsync (utf8Json As PipeWriter, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- utf8Json
- PipeWriter
O UTF-8 PipeWriter para escrever.
- value
- Object
O valor a converter.
- inputType
- Type
O tipo do value para converter.
- options
- JsonSerializerOptions
Opções para controlar o comportamento de conversão.
- cancellationToken
- CancellationToken
Isso CancellationToken pode ser usado para cancelar a operação de escrita.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
- Atributos
Exceções
inputType não é compatível com value.
utf8Json ou inputType é null.
Não há membros compatíveis JsonConverter para inputType nem serializáveis.
Aplica-se a
SerializeAsync<TValue>(PipeWriter, TValue, JsonSerializerOptions, CancellationToken)
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no PipeWriterarquivo .
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);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);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member SerializeAsync : System.IO.Pipelines.PipeWriter * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Taskstatic member SerializeAsync : System.IO.Pipelines.PipeWriter * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function SerializeAsync(Of TValue) (utf8Json As PipeWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros de Tipo Genérico
- TValue
O tipo do valor a serializar.
Parâmetros
- utf8Json
- PipeWriter
O UTF-8 PipeWriter para escrever.
- value
- TValue
O valor a converter.
- options
- JsonSerializerOptions
Opções para controlar o comportamento de conversão.
- cancellationToken
- CancellationToken
Isso CancellationToken pode ser usado para cancelar a operação de escrita.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
- Atributos
Exceções
utf8Json é null.
Não há membros compatíveis JsonConverter para TValue nem serializáveis.
Aplica-se a
SerializeAsync<TValue>(PipeWriter, TValue, JsonTypeInfo<TValue>, CancellationToken)
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
- Origem:
- JsonSerializer.Write.Pipe.cs
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no PipeWriterarquivo .
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.TaskPublic Function SerializeAsync(Of TValue) (utf8Json As PipeWriter, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros de Tipo Genérico
- TValue
O tipo do valor a serializar.
Parâmetros
- utf8Json
- PipeWriter
O UTF-8 PipeWriter para escrever.
- value
- TValue
O valor a converter.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a converter.
- cancellationToken
- CancellationToken
Isso CancellationToken pode ser usado para cancelar a operação de escrita.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
Exceções
utf8Json é null.
Aplica-se a
SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)
Converte assíncronamente um valor de um tipo especificado por um parâmetro genérico de tipo para texto JSON codificado em UTF-8 e escreve-o num fluxo.
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Taskstatic member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Shared Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros de Tipo Genérico
- TValue
O tipo do valor a serializar.
Parâmetros
- utf8Json
- Stream
O fluxo UTF-8 para escrever.
- value
- TValue
O valor a converter.
- options
- JsonSerializerOptions
Opções para controlar o comportamento de serialização.
- cancellationToken
- CancellationToken
Um token que pode ser usado para cancelar a operação de escrita.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
- Atributos
Exceções
utf8Json é null.
Não há membros compatíveis JsonConverter para TValue nem serializáveis.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações, veja Como serializar e desserializar JSON.
Aplica-se a
SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)
Converte o valor fornecido para texto JSON codificado em UTF-8 e escreve-o no Streamarquivo .
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.TaskPublic Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros de Tipo Genérico
- TValue
O tipo do valor a serializar.
Parâmetros
- value
- TValue
O valor a converter.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a converter.
- cancellationToken
- CancellationToken
Isso CancellationToken pode ser usado para cancelar a operação de escrita.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
Exceções
utf8Json é null.
Não há membros compatíveis JsonConverter para TValue nem serializáveis.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
