JsonDocument.ParseAsync Metoda

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

Zdroj:

JsonDocument.Parse.cs

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

Task<JsonDocument>

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

Výjimky

JsonException

utf8Json nepředstavuje platnou jednu hodnotu JSON.

ArgumentException

options obsahuje nepodporované možnosti.

OperationCanceledException

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).