JsonDocument.ParseAsync Methode

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Source:

JsonDocument.Parse.cs

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

Task<JsonDocument>

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

Ausnahmen

JsonException

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

ArgumentException

options enthält nicht unterstützte Optionen.

OperationCanceledException

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.