JsonSerializer.DeserializeAsync 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 |
|---|---|
| DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken) |
Lê o texto codificado em UTF-8 que representa um único valor JSON num |
| DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
Lê assíncronamente o texto codificado em UTF-8 que representa um único valor JSON numa instância de um tipo especificado. A transmissão será lida até ao fim. |
| DeserializeAsync(PipeReader, Type, JsonSerializerContext, CancellationToken) |
Lê o texto codificado em UTF-8 que representa um único valor JSON num O PipeReader será lido até ao fim. |
| DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Lê o texto codificado em UTF-8 que representa um único valor JSON numa instância especificada pelo |
| DeserializeAsync(PipeReader, JsonTypeInfo, CancellationToken) |
Lê o texto codificado em UTF-8 que representa um único valor JSON numa instância especificada pelo O PipeReader será lido até ao fim. |
| DeserializeAsync(PipeReader, Type, JsonSerializerOptions, CancellationToken) |
Lê o texto codificado em UTF-8 que representa um único valor JSON num O PipeReader será lido até ao fim. |
| DeserializeAsync<TValue>(PipeReader, JsonSerializerOptions, CancellationToken) |
Lê o texto codificado em UTF-8 que representa um único valor JSON num O PipeReader será lido até ao fim. |
| DeserializeAsync<TValue>(PipeReader, JsonTypeInfo<TValue>, CancellationToken) |
Lê o texto codificado em UTF-8 que representa um único valor JSON num O PipeReader será lido até ao fim. |
| DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken) |
Lê assíncronamente o texto codificado em UTF-8 que representa um único valor JSON numa instância de um tipo especificado por um parâmetro genérico de tipo. A transmissão será lida até ao fim. |
| DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Lê o texto codificado em UTF-8 que representa um único valor JSON num |
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)
Lê o texto codificado em UTF-8 que representa um único valor JSON num returnType.
O Stream será lido até ao fim.
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 para analisar.
- returnType
- Type
O tipo de objeto a converter e a devolver.
- context
- JsonSerializerContext
Um fornecedor de metadados para tipos serializáveis.
- cancellationToken
- CancellationToken
O CancellationToken que pode ser usado para cancelar a operação de leitura.
Devoluções
Uma returnType representação do valor JSON.
Exceções
utf8Json, returnType, ou context é null.
O JSON é inválido, não returnType é compatível com o JSON, ou ainda há dados no Stream.
Não há membros compatíveis JsonConverter para returnType nem serializáveis.
O GetTypeInfo(Type) método no fornecido context não devolveu um compatível JsonTypeInfo para returnType.
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 Deserialize(Stream, Type, JsonSerializerContext).
Aplica-se a
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)
Lê assíncronamente o texto codificado em UTF-8 que representa um único valor JSON numa instância de um tipo especificado. A transmissão será lida até ao fim.
[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.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);[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.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);[<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 DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>[<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 DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)Public Shared 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 para analisar.
- returnType
- Type
O tipo de objeto a converter e a devolver.
- 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.
Devoluções
Uma returnType representação do valor JSON.
- Atributos
Exceções
utf8Json ou returnType é null.
O JSON é inválido.
-ou-
TValue não é compatível com o JSON.
-ou-
Restam dados no fluxo.
Não há membros compatíveis JsonConverter para returnType 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 Deserialize(Stream, Type, JsonSerializerOptions).
Aplica-se a
DeserializeAsync(PipeReader, Type, JsonSerializerContext, CancellationToken)
- Origem:
- JsonSerializer.Read.Pipe.cs
- Origem:
- JsonSerializer.Read.Pipe.cs
- Origem:
- JsonSerializer.Read.Pipe.cs
Lê o texto codificado em UTF-8 que representa um único valor JSON num returnType.
O PipeReader será lido até ao fim.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Pipelines.PipeReader utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Pipelines.PipeReader * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>Public Function DeserializeAsync (utf8Json As PipeReader, returnType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)Parâmetros
- utf8Json
- PipeReader
Dados JSON para analisar.
- returnType
- Type
O tipo de objeto a converter e a devolver.
- context
- JsonSerializerContext
Um fornecedor de metadados para tipos serializáveis.
- cancellationToken
- CancellationToken
O CancellationToken que pode ser usado para cancelar a operação de leitura.
Devoluções
Uma returnType representação do valor JSON.
Exceções
utf8Json, returnType, ou context é null.
O JSON é inválido, returnType não é compatível com o JSON, ou ainda há dados remanescentes no PipeReader.
Não há membros compatíveis JsonConverter para returnType nem serializáveis.
O GetTypeInfo(Type) método no fornecido context não devolveu um compatível JsonTypeInfo para returnType.
Aplica-se a
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
Lê o texto codificado em UTF-8 que representa um único valor JSON numa instância especificada pelo jsonTypeInfo.
O Stream será lido até ao fim.
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 para analisar.
- jsonTypeInfo
- JsonTypeInfo
Metadados sobre o tipo a converter.
- cancellationToken
- CancellationToken
O CancellationToken que pode ser usado para cancelar a operação de leitura.
Devoluções
Uma jsonTypeInfo representação do valor JSON.
Exceções
utf8Json ou jsonTypeInfo é null.
O JSON é inválido, ou ainda há dados remanescentes no Stream.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Aplica-se a
DeserializeAsync(PipeReader, JsonTypeInfo, CancellationToken)
- Origem:
- JsonSerializer.Read.Pipe.cs
- Origem:
- JsonSerializer.Read.Pipe.cs
- Origem:
- JsonSerializer.Read.Pipe.cs
Lê o texto codificado em UTF-8 que representa um único valor JSON numa instância especificada pelo jsonTypeInfo.
O PipeReader será lido até ao fim.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Pipelines.PipeReader utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Pipelines.PipeReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>Public Function DeserializeAsync (utf8Json As PipeReader, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)Parâmetros
- utf8Json
- PipeReader
Dados JSON para analisar.
- jsonTypeInfo
- JsonTypeInfo
Metadados sobre o tipo a converter.
- cancellationToken
- CancellationToken
O CancellationToken que pode ser usado para cancelar a operação de leitura.
Devoluções
Uma jsonTypeInfo representação do valor JSON.
Exceções
utf8Json ou jsonTypeInfo é null.
O JSON é inválido, ou restam dados no PipeReader.
Aplica-se a
DeserializeAsync(PipeReader, Type, JsonSerializerOptions, CancellationToken)
- Origem:
- JsonSerializer.Read.Pipe.cs
- Origem:
- JsonSerializer.Read.Pipe.cs
- Origem:
- JsonSerializer.Read.Pipe.cs
Lê o texto codificado em UTF-8 que representa um único valor JSON num returnType.
O PipeReader será lido até ao fim.
[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.ValueTask<object?> DeserializeAsync(System.IO.Pipelines.PipeReader utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Pipelines.PipeReader utf8Json, Type returnType, 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 DeserializeAsync : System.IO.Pipelines.PipeReader * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>static member DeserializeAsync : System.IO.Pipelines.PipeReader * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>Public Function DeserializeAsync (utf8Json As PipeReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)Parâmetros
- utf8Json
- PipeReader
Dados JSON para analisar.
- returnType
- Type
O tipo de objeto a converter e a devolver.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a leitura.
- cancellationToken
- CancellationToken
O CancellationToken que pode ser usado para cancelar a operação de leitura.
Devoluções
Uma returnType representação do valor JSON.
- Atributos
Exceções
utf8Json ou returnType é null.
O JSON é inválido, returnType não é compatível com o JSON, ou ainda há dados remanescentes no PipeReader.
Não há membros compatíveis JsonConverter para returnType nem serializáveis.
Aplica-se a
DeserializeAsync<TValue>(PipeReader, JsonSerializerOptions, CancellationToken)
- Origem:
- JsonSerializer.Read.Pipe.cs
- Origem:
- JsonSerializer.Read.Pipe.cs
- Origem:
- JsonSerializer.Read.Pipe.cs
Lê o texto codificado em UTF-8 que representa um único valor JSON num TValue.
O PipeReader será lido até ao fim.
[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.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Pipelines.PipeReader utf8Json, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Pipelines.PipeReader utf8Json, 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 DeserializeAsync : System.IO.Pipelines.PipeReader * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>static member DeserializeAsync : System.IO.Pipelines.PipeReader * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>Public Function DeserializeAsync(Of TValue) (utf8Json As PipeReader, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)Parâmetros de Tipo Genérico
- TValue
O tipo para desserializar o valor JSON.
Parâmetros
- utf8Json
- PipeReader
Dados JSON para analisar.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a leitura.
- cancellationToken
- CancellationToken
O CancellationToken que pode ser usado para cancelar a operação de leitura.
Devoluções
Uma TValue representação do valor JSON.
- Atributos
Exceções
utf8Json é null.
O JSON é inválido, TValue não é compatível com o JSON, ou ainda há dados remanescentes no PipeReader.
Não há membros compatíveis JsonConverter para TValue nem serializáveis.
Aplica-se a
DeserializeAsync<TValue>(PipeReader, JsonTypeInfo<TValue>, CancellationToken)
- Origem:
- JsonSerializer.Read.Pipe.cs
- Origem:
- JsonSerializer.Read.Pipe.cs
- Origem:
- JsonSerializer.Read.Pipe.cs
Lê o texto codificado em UTF-8 que representa um único valor JSON num TValue.
O PipeReader será lido até ao fim.
public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Pipelines.PipeReader utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);static member DeserializeAsync : System.IO.Pipelines.PipeReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>Public Function DeserializeAsync(Of TValue) (utf8Json As PipeReader, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)Parâmetros de Tipo Genérico
- TValue
O tipo para desserializar o valor JSON.
Parâmetros
- utf8Json
- PipeReader
Dados JSON para analisar.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a converter.
- cancellationToken
- CancellationToken
O CancellationToken que pode ser usado para cancelar a operação de leitura.
Devoluções
Uma TValue representação do valor JSON.
Exceções
utf8Json ou jsonTypeInfo é null.
O JSON é inválido, TValue não é compatível com o JSON, ou ainda há dados remanescentes no PipeReader.
Aplica-se a
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)
Lê assíncronamente o texto codificado em UTF-8 que representa um único valor JSON numa instância de um tipo especificado por um parâmetro genérico de tipo. A transmissão será lida até ao fim.
[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.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);[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.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);[<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 DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>static member DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>[<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 DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)Public Shared 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 Genérico
- TValue
O tipo-alvo do valor JSON.
Parâmetros
- utf8Json
- Stream
Os dados JSON para analisar.
- 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.
Devoluções
Uma TValue representação do valor JSON.
- Atributos
Exceções
O JSON é inválido.
-ou-
TValue não é compatível com o JSON.
-ou-
Restam dados no fluxo.
Não há membros compatíveis JsonConverter para TValue nem serializáveis.
utf8Jsoné null.
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
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)
Lê o texto codificado em UTF-8 que representa um único valor JSON num TValue.
O Stream será lido até ao fim.
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 Genérico
- TValue
O tipo para desserializar o valor JSON.
Parâmetros
- utf8Json
- Stream
Dados JSON para analisar.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a converter.
- cancellationToken
- CancellationToken
O CancellationToken que pode ser usado para cancelar a operação de leitura.
Devoluções
Uma TValue representação do valor JSON.
Exceções
utf8Json ou jsonTypeInfo é null.
O JSON é inválido, TValue não é compatível com o JSON, ou ainda há dados remanescentes no Stream.
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.
