JsonDocument.ParseAsync メソッド

定義

単一の JSON 値を表す UTF-8 エンコード データとして Stream を JsonDocument に解析します。 ストリームは最後まで読み取られます。

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)

パラメーター

utf8Json
Stream

解析対象の JSON データ。

options
JsonDocumentOptions

解析中にリーダーの動作を制御するオプション。

cancellationToken
CancellationToken

キャンセル要求を監視するためのトークン。

戻り値

JSON 値の JsonDocument 表現を作成するタスク。

例外

utf8Json では、有効な単一の JSON 値が表現されていません。

options に、サポート対象外のオプションが含まれています。

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Parse(Stream, JsonDocumentOptions)スローされる例外に関するページを参照してください。

適用対象