JsonSerializer.DeserializeAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken) |
Lê o texto codificado em UTF-8 que representa um único valor JSON em um |
| DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Lê o texto codificado em UTF-8 que representa um único valor JSON em uma instância especificada pelo |
| DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
Lê de forma assíncrona o texto codificado em UTF-8 que representa um único valor JSON em uma instância de um tipo especificado. O fluxo será lido até a conclusão. |
| DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Lê o texto codificado em UTF-8 que representa um único valor JSON em um |
| DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken) |
Lê de forma assíncrona o texto codificado em UTF-8 que representa um único valor JSON em uma instância de um tipo especificado por um parâmetro de tipo genérico. O fluxo será lido até a conclusão. |
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)
Lê o texto codificado em UTF-8 que representa um único valor JSON em um returnType.
O Stream será lido até a conclusão.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)Parâmetros
- utf8Json
- Stream
Dados JSON a serem analisados.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- context
- JsonSerializerContext
Um provedor de metadados para tipos serializáveis.
- cancellationToken
- CancellationToken
O CancellationToken que pode ser usado para cancelar a operação de leitura.
Retornos
Uma representação returnType do valor JSON.
Exceções
utf8Json, returnType ou context é null.
O JSON é inválido, o returnType não é compatível com o JSON ou há dados restantes no Stream.
Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.
O GetTypeInfo(Type) método no fornecido context não retornou um compatível JsonTypeInfo para returnType.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Deserialize(Stream, Type, JsonSerializerContext).
Aplica-se a
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
Lê o texto codificado em UTF-8 que representa um único valor JSON em uma instância especificada pelo jsonTypeInfo.
O Stream será lido até a conclusão.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>Public Function DeserializeAsync (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)Parâmetros
- utf8Json
- Stream
Dados JSON a serem analisados.
- jsonTypeInfo
- JsonTypeInfo
Metadados sobre o tipo a ser convertido.
- cancellationToken
- CancellationToken
O CancellationToken que pode ser usado para cancelar a operação de leitura.
Retornos
Uma representação jsonTypeInfo do valor JSON.
Exceções
utf8Json ou jsonTypeInfo é null.
O JSON é inválido ou quando há dados restantes no Stream.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Aplica-se a
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)
Lê de forma assíncrona o texto codificado em UTF-8 que representa um único valor JSON em uma instância de um tipo especificado. O fluxo será lido até a conclusão.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.ValueTask<object> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>Public Shared Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)Parâmetros
- utf8Json
- Stream
Os dados JSON a serem analisados.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a leitura.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado para cancelar a operação de leitura.
Retornos
Uma representação returnType do valor JSON.
Exceções
utf8Json ou returnType é null.
O JSON é inválido.
- ou -
TValue não é compatível com o JSON.
- ou -
Há dados restantes no fluxo.
Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Para obter mais informações, consulte Como serializar e desserializar o JSON.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Deserialize(Stream, Type, JsonSerializerOptions).
Aplica-se a
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)
Lê o texto codificado em UTF-8 que representa um único valor JSON em um TValue.
O Stream será lido até a conclusão.
public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- utf8Json
- Stream
Dados JSON a serem analisados.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a ser convertido.
- cancellationToken
- CancellationToken
O CancellationToken que pode ser usado para cancelar a operação de leitura.
Retornos
Uma representação TValue do valor JSON.
Exceções
utf8Json ou jsonTypeInfo é null.
O JSON é inválido, TValue não é compatível com o JSON ou há dados restantes no Stream.
Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Aplica-se a
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)
Lê de forma assíncrona o texto codificado em UTF-8 que representa um único valor JSON em uma instância de um tipo especificado por um parâmetro de tipo genérico. O fluxo será lido até a conclusão.
public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.ValueTask<TValue> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>Public Shared Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)Parâmetros de tipo
- TValue
O tipo de destino do valor JSON.
Parâmetros
- utf8Json
- Stream
Os dados JSON a serem analisados.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a leitura.
- cancellationToken
- CancellationToken
Um token que pode ser usado para cancelar a operação de leitura.
Retornos
Uma representação TValue do valor JSON.
Exceções
O JSON é inválido.
- ou -
TValue não é compatível com o JSON.
- ou -
Há dados restantes no fluxo.
Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.
utf8Json é null.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Para obter mais informações, consulte Como serializar e desserializar o JSON.
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de