Sdílet prostřednictvím


JsonDocument.ParseAsync Metoda

Definice

Stream Analyzuje data zakódovaná jako UTF-8 představující jednu hodnotu JSON do jsonDocument. Datový proud se přečte až do dokončení.

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

Data JSON, která se mají analyzovat.

options
JsonDocumentOptions

Možnosti řízení chování čtenáře během analýzy

cancellationToken
CancellationToken

Token, který se má monitorovat pro žádosti o zrušení.

Návraty

Úkol, který vytvoří reprezentaci jsonDocument hodnoty JSON.

Výjimky

utf8Json nepředstavuje platnou jednu hodnotu JSON.

options obsahuje nepodporované možnosti.

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Parse(Stream, JsonDocumentOptions).

Platí pro