JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Metode

Definisi

Ruang nama:

System.Text.Json

Rakitan:

System.Text.Json.dll

Paket:

System.Text.Json v11.0.0-preview.5.26302.115

Sumber:

JsonDocument.Parse.cs

Mencoba mengurai satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan.

public:
 static bool TryParseValue(System::Text::Json::Utf8JsonReader % reader, [Runtime::InteropServices::Out] System::Text::Json::JsonDocument ^ % document);

public static bool TryParseValue(ref System.Text.Json.Utf8JsonReader reader, out System.Text.Json.JsonDocument? document);

static member TryParseValue : Utf8JsonReader * JsonDocument -> bool

Public Shared Function TryParseValue (ByRef reader As Utf8JsonReader, ByRef document As JsonDocument) As Boolean

Parameter

reader

Utf8JsonReader

Pembaca yang akan dibaca.

document

JsonDocument

Saat metode kembali, berisi dokumen yang diurai.

Mengembalikan

Boolean

true jika nilai dibaca dan diuraikan ke dalam JsonDocument; false jika pembaca kehabisan data saat mengurai. Semua situasi lainnya mengakibatkan pengecualian dilemparkan.

Pengecualian

ArgumentException

reader berisi opsi yang tidak didukung.

-atau-

Token saat ini reader tidak memulai atau mewakili nilai.

JsonException

Nilai tidak dapat dibaca dari pembaca.

Keterangan

TokenType Jika properti adalah readerJsonTokenType.PropertyName atau JsonTokenType.None, pembaca akan melanjutkan satu panggilan ke Utf8JsonReader.Read() untuk menentukan awal nilai.

Setelah menyelesaikan metode ini, reader diposisikan pada token akhir dalam nilai JSON. Jika pengecualian dilemparkan atau false dikembalikan, pembaca diatur ulang ke status saat metode dipanggil.

Metode ini membuat salinan data yang ditindaklanjuti pembaca, sehingga tidak ada persyaratan pemanggil untuk mempertahankan integritas data di luar pengembalian metode ini.