Freigeben über


JsonDocument.ParseAsync Methode

Definition

Analysiert einen Stream als UTF-8-codierte Daten, die einen einzelnen JSON-Wert in einem JsonDocument darstellen. Der Stream wird vollständig gelesen.

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)

Parameter

utf8Json
Stream

Die zu analysierenden JSON-Daten.

options
JsonDocumentOptions

Optionen zum Steuern des Readerverhaltens während der Analyse.

cancellationToken
CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.

Gibt zurück

Eine Aufgabe zum Produzieren einer JsonDocument-Darstellung des JSON-Werts.

Ausnahmen

utf8Json stellt keinen gültigen einzelnen JSON-Wert dar.

options enthält nicht unterstützte Optionen.

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Parse(Stream, JsonDocumentOptions)Ausnahmen.

Gilt für: