JsonDocument.ParseAsync Metoda

Definicja

Przestrzeń nazw:

System.Text.Json

Zestaw:

System.Text.Json.dll

Pakiet:

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

Źródło:

JsonDocument.Parse.cs

Analizuje jako zakodowane Stream w formacie UTF-8 dane reprezentujące pojedynczą wartość JSON do dokumentu JsonDocument. Strumień jest odczytywany do ukończenia.

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)

Parametry

utf8Json

Stream

Dane JSON do analizy.

options

JsonDocumentOptions

Opcje kontrolowania zachowania czytelnika podczas analizowania.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania.

Zwraca

Task<JsonDocument>

Zadanie utworzenia reprezentacji JsonDocument wartości JSON.

Wyjątki

JsonException

utf8Json nie reprezentuje prawidłowej pojedynczej wartości JSON.

ArgumentException

options zawiera nieobsługiwane opcje.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Parse(Stream, JsonDocumentOptions)usługę .