JsonDocument.ParseAsync Metodo

Definizione

Analizza un oggetto Stream come dati con codifica UTF-8 che rappresentano un singolo valore JSON in jsonDocument. Il flusso viene letto fino al completamento.

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)

Parametri

utf8Json
Stream

Dati JSON da analizzare.

options
JsonDocumentOptions

Opzioni per controllare il comportamento del lettore durante l'analisi.

cancellationToken
CancellationToken

Token da monitorare per le richieste di annullamento.

Valori restituiti

Attività per produrre una rappresentazione JsonDocument del valore JSON.

Eccezioni

utf8Json non rappresenta un singolo valore JSON valido.

options contiene opzioni non supportate.

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Parse(Stream, JsonDocumentOptions).

Si applica a