JsonDocument.ParseAsync Metodo

Definizione

Spazio dei nomi:

System.Text.Json

Assembly:

System.Text.Json.dll

Pacchetto:

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

Origine:

JsonDocument.Parse.cs

Analizza un elemento Stream come dati con codifica UTF-8 che rappresentano un valore JSON singolo in un 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.

Restituisce

Task<JsonDocument>

Attività che crea una rappresentazione JsonDocument del valore JSON.

Eccezioni

JsonException

utf8Json non rappresenta un valore JSON singolo valido.

ArgumentException

options contiene opzioni non supportate.

OperationCanceledException

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

Commenti

Questo metodo archivia nell'attività 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).