JsonDocument.ParseAsync Método

Definição

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Pacote:

System.Text.Json v9.0.0-preview.3.24172.9

Origem:

JsonDocument.Parse.cs

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

Task<JsonDocument>

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

Exceções

JsonException

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

ArgumentException

options contém opções sem suporte.

OperationCanceledException

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).