JsonDocument.ParseAsync Método

Definición

Espacio de nombres:

System.Text.Json

Ensamblado:

System.Text.Json.dll

Source:

JsonDocument.Parse.cs

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

Task<JsonDocument>

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

Excepciones

JsonException

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

ArgumentException

options contiene opciones no compatibles.

OperationCanceledException

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