JsonDocument.ParseAsync Metode

Definisi

Ruang nama:

System.Text.Json

Rakitan:

System.Text.Json.dll

Sumber:

JsonDocument.Parse.cs

Mengurai Stream sebagai data yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam JsonDocument. Aliran dibaca hingga selesai.

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

Data JSON yang akan diurai.

options

JsonDocumentOptions

Opsi untuk mengontrol perilaku pembaca selama penguraian.

cancellationToken

CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

Task<JsonDocument>

Tugas untuk menghasilkan representasi JsonDocument dari nilai JSON.

Pengecualian

JsonException

utf8Json tidak mewakili nilai JSON tunggal yang valid.

ArgumentException

options berisi opsi yang tidak didukung.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Parse(Stream, JsonDocumentOptions).