JsonDocument.ParseAsync Methode

Definition

Analysiert eine Stream als UTF-8-codierte Daten, die einen einzelnen JSON-Wert in ein JsonDocument darstellen. Der Datenstrom wird nach Abschluss 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 Leseverhaltens während der Analyse.

cancellationToken
CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll.

Gibt zurück

Eine Aufgabe zum Erstellen 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 alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Parse(Stream, JsonDocumentOptions).

Gilt für: