Compartilhar via


JsonDocument.ParseAsync Método

Definição

Analisa um Stream como dados codificados em UTF-8 que representam um único valor JSON em um JsonDocument. O fluxo é lido até a conclusão.

public static System.Threading.Tasks.Task<System.Text.Json.JsonDocument> ParseAsync (System.IO.Stream utf8Json, System.Text.Json.JsonDocumentOptions options = default, System.Threading.CancellationToken cancellationToken = default);
static member ParseAsync : System.IO.Stream * System.Text.Json.JsonDocumentOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Text.Json.JsonDocument>
Public Shared Function ParseAsync (utf8Json As Stream, Optional options As JsonDocumentOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of JsonDocument)

Parâmetros

utf8Json
Stream

Os dados JSON a serem analisados.

options
JsonDocumentOptions

Opções para controlar o comportamento do leitor durante a análise.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento.

Retornos

Uma tarefa para produzir uma representação de JsonDocument do valor JSON.

Exceções

utf8Json não representa um único valor JSON válido.

options contém opções sem suporte.

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 o equivalente síncrono 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 Parse(Stream, JsonDocumentOptions).

Aplica-se a