Compartir vía


JsonDocument.ParseAsync Método

Definición

Analiza un objeto Stream como datos codificados con UTF-8 que representan un único valor JSON en un objeto JsonDocument. La secuencia se lee hasta su finalización.

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

Datos JSON que se van a analizar.

options
JsonDocumentOptions

Opciones para controlar el comportamiento de los lectores durante el análisis.

cancellationToken
CancellationToken

Token para supervisar solicitudes de cancelación.

Devoluciones

Tarea que genera una representación JsonDocument del valor JSON.

Excepciones

utf8Json no representa un único valor JSON válido.

options contiene opciones no compatibles.

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Parse(Stream, JsonDocumentOptions).

Se aplica a